Hatalar
Hata durumunda, standart biçimde bir hata yanıtı gövdesi döndürülür ve HTTP durum kodu hata durumuna ayarlanır.
Yanıtta aşağıdaki anahtarlara sahip tek bir error
nesnesi içeren bir nesne bulunur:
code
: Bu, yanıtın HTTP durumuyla aynıdır.message
: Hatanın kısa açıklamasıdır.status
: Hatanın türünü belirten bir durum kodu.
Örneğin, geçersiz bir placeId
parametresi gönderildiğinde aşağıdaki hata döndürülür:
{ "error": { "code": 400, "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"", "status": "INVALID_ARGUMENT" } }
Olası hatalar aşağıdakileri içerir:
Kod | Durum | Mesaj | Sorun giderme |
---|---|---|---|
400 | INVALID_ARGUMENT |
Sağladığınız anahtar geçersiz. | API anahtarınız geçerli değil veya isteğe dahil edilmedi. Lütfen anahtarın tamamını eklediğinizden ve bu anahtar için API'yi etkinleştirdiğinizden emin olun. |
400 | INVALID_ARGUMENT |
"\"path\" parametresi geçersiz bir değer içeriyor: ☃" | İsteğiniz geçersiz bağımsız değişkenler içeriyordu. Bu hatanın en olası nedenleri şunlardır:
Artık mevcut olmayan bir yol veya yol olmayan bir yer için |
403 | PERMISSION_DENIED |
Kayıtlı olmayan istek engellendi. Lütfen Google Developers Console'u kullanarak kaydolun. | İstek, aşağıdaki nedenlerden biri veya daha fazlası nedeniyle reddedildi:
Google Haritalar Platformu ürünlerini kullanmak için hesabınızda faturalandırma etkinleştirilmeli ve tüm istekler geçerli bir API anahtarı içermelidir. Bu sorunu düzeltmek için aşağıdaki adımları uygulayın:
|
404 | NOT_FOUND |
Bu hizmet için HTTPS gereklidir. | İstekleri https://roads.googleapis.com/ adresine gönderdiğinizden ve http://roads.googleapis.com/ adresine göndermediğinizden emin olun. |
429 | RESOURCE_EXHAUSTED |
Proje isteği sınırlarına ulaşıldığı için istek sınırlandırıldı. | Google Cloud Platform Console'da yapılandırdığınız istek sınırını aştınız. Bu sınır genellikle günlük istek sayısı, 100 saniyede istek sayısı ve kullanıcı başına 100 saniyede istek sayısı olarak belirlenir. Bu sınır, tek bir kullanıcının veya küçük bir kullanıcı grubunun günlük kotanızı tüketmesini önleyecek şekilde yapılandırılmalıdır. Bu sayede, tüm kullanıcılar makul düzeyde erişim sağlayabilir. Bu sınırları yapılandırmak için API kullanımını sınırlama başlıklı makaleyi inceleyin. |
Eksponansiyel geri yükleme
İstekler başarısız olduğunda, istekleri üstel geri çekilme ile yeniden denediğinizden emin olmanız gerekir. Örneğin, bir istek bir kez başarısız olursa bir saniye sonra, tekrar başarısız olursa iki saniye sonra, ardından dört saniye sonra ve bu şekilde devam ederek yeniden deneyin. Bu sayede, birçok istemci istekleri çok hızlı bir şekilde yeniden denemeye çalıştığından bozuk istekler veya büyük ölçekli hatalar Google'ın sunucularını doldurmaz.
Sorun giderme ile ilgili SSS
Uygulama sorunları
- Araç konumumu hangi sıklıkta örneklemeliyim?
- Yüksek kaliteli yola tutturma sonuçları için 1-10 saniye aralığı önerilir.
- Sorgu başına gönderebileceğim puan sayısı sınırlı mı?
- Evet, bir sorguda en fazla 100 puan olabilir.
- Çektiğim enlem/boylam çiftlerini saklamak için hangi kesinlik düzeyini kullanmalıyım?
- Yakalanan yolların, maksimum yakınlaştırma düzeyinde bile tüm yakınlaştırma düzeylerinde yolları takip etmesini sağlamak için yakalanan enlem/boylam çiftlerinizi 7 ondalık basamak hassasiyetinde saklamanız gerekir.
- Çıtçıtlanmış yolları göstermek için kodlanmış çoklu çizgiler kullanabilir miyim?
- Kodlanmış çoklu çizgiler yalnızca 5 ondalık basamak hassasiyetinde belirtilir. Bu da yaklaşık 2 metrelik bir hataya neden olur. Bu nedenle, yakalanan yollarınızın yüksek yakınlaştırma düzeylerinde yolu takip etmesini istiyorsanız kodlanmış çoklu çizgiler uygun değildir.
Genel sorunlar
- Bazı noktalar sabitlenmiyor veya sabitlenmiş yollarda boşluklar var. Bu durumu nasıl düzeltebilirim?
-
- Noktalarınızı belirli aralıklarla örnekliyorsanız noktalarınızın daha kısa aralıklarla (1-10 saniyede bir) örneklendiğinden emin olun. Daha uzun bir aralık kullanılırsa (örneğin 60 saniye) yola tutturma algoritması, gidilen yolları yeterli doğrulukta belirleyemeyebilir.
- Nokta oluşturmak için haritayı manuel olarak tıklıyorsanız çok az nokta içeren veya tutturma algoritmasının iyi işlemeyeceği seyrek noktalar içeren yollar oluşturmak çok kolaydır. Yakalama algoritması, birbirine yakın noktalar için en iyi sonucu verir. Yollara yapışma demosunu deneyin veya yollarınızı test etmek için Yol denetçisini kullanın.
- Yakınlaştırdığımda tutturulan yollar neden tırtıklı veya yoldan biraz uzakta görünüyor?
-
- Gösterilmeden önce sabitlenen enlem/boylam çiftlerinin hassasiyetini kısaltıyor musunuz? Yakalanan enlem/boylam çiftlerinin 7 ondalık noktadan daha düşük bir hassasiyetle depolanması, yakalanan yol haritada gösterildiğinde hassasiyet hatalarına neden olur.
- Kodlanmış çoklu çizgiler kullanıyor musunuz? Kodlanmış çoklu çizgiler, enlem/boylam çiftlerini 5 ondalık basamağa kısaltır. Bu durum, birkaç metrelik bir hataya neden olur ve yüksek yakınlaştırma düzeylerinde çizgilerin tırtıklı veya yoldan biraz uzak olmasına yol açar.
Yukarıdaki durumlardan hiçbiri söz konusu değilse harita döşemeleri yakın zamanda güncellenmiş olabilir. Bu durumda, döşemeler, tutturma için kullanılan yol diziniyle senkronize olmaz. Yalnızca birkaç sorgunuz etkileniyorsa bunun nedeni büyük olasılıkla budur. Google Haritalar düzenli olarak güncellendiğinden bu durum zaman zaman yaşanabilir. Ayrıca, haritada eski yollara (ör. birkaç hafta önce sabitlenmiş yollar) düzenli olarak bakarsanız bu durum daha sık görülebilir. En iyi görselleştirme için, eski yolları haritada göstermeden hemen önce yeniden yerleştirmeniz gerekir. Böylece, harita parçaları ile yerleştirme için kullanılan yol indeksi arasındaki tutarsızlıklar en aza indirilir.
- X yolu için hız sınırının yanlış gösterilmesine ne neden olabilir?
- Hız sınırları, doğruluk ve kapsam açısından farklılık gösteren çeşitli kaynaklardan alınır.
Belirli bir yol türü veya belirli bir alandaki hız sınırlarının sürekli olarak yanlış olması gibi bir kalıp fark ederseniz lütfen aşağıdaki adımları uygulayarak bize bildirin:
- Masaüstü bilgisayarınızda Google Haritalar'ı VEYA Android için Google Haritalar uygulamasını açın.
- Soldaki yan menüyü açın.
- Geri bildirim gönder'i seçin. Not: Giriş yapmanız istenebilir.
- Haritayı düzenleyin'i seçin.
- Düzenlemek istediğiniz yol segmentini seçin.
- İleri'yi seçin.
- "Diğer" alanında, hız sınırının söz konusu yol için yanlış olduğunu belirtin.
- Gönder'i seçin.
- Neden tutturulan rotam yolu takip etmek yerine köşeleri kesiyor?
-
Bu sorunu düzeltmek için aşağıdakileri kontrol edin:
interpolate
parametresinintrue
olarak ayarlandığından emin olun.- Orijinal veri noktalarınızın yeterince kısa aralıklarla (1-10 saniyede bir) örneklenip örneklenmediğini kontrol edin.
- Hız sınırı değişikliklerinin olmadığı bir yolda, sabitlenmiş rotada neden çok sayıda yol segmenti döndürülüyor?
-
interpolate
parametresitrue
olarak ayarlandığında, yola tutturma sorgusu, köşeler, virajlar ve kavşaklar etrafında yolu takip eden bir çoklu çizgi döndürür. Yol kıvrılıyorsa hız sınırı değişmese bile yol geometrisini yakından takip eden bir çoklu çizgi oluşturmak için birden fazla yol segmenti döndürülür.