Hatalar
Bir hata olması durumunda standart biçimli bir hata yanıtı gövdesi döndürülür ve HTTP durum kodu bir hata durumuna ayarlanır.
Yanıt, aşağıdaki anahtarlara sahip tek bir error
nesnesine sahip bir nesne içerir:
code
: Bu, yanıtın HTTP durumu ile aynıdır.message
: Hatanın kısa açıklaması.status
: Hatanın yapısı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 | Message | Sorun giderme |
---|---|---|---|
400 | INVALID_ARGUMENT |
Girdiğiniz 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çeriyor. Bu hatanın en olası nedenleri şunlardır:
Artık var 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ğıdakilerden biri veya birkaçı nedeniyle reddedildi:
Google Haritalar Platformu ürünlerini kullanabilmeniz için hesabınızda faturalandırmanın etkinleştirilmiş olması ve tüm isteklerin geçerli bir API anahtarı içermesi gerekir. Bunu düzeltmek için aşağıdaki adımları uygulayın:
|
404 | NOT_FOUND |
Bu hizmet için HTTPS gerekiyor. | http://roads.googleapis.com/ adresine değil, https://roads.googleapis.com/ adresine istek gönderdiğinizden emin olun. |
429 | RESOURCE_EXHAUSTED |
Proje istek sınırlarına ulaşıldığından istek kısıtlandı. | 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 saniye başına istek sayısı ve kullanıcı başına 100 saniye başına istek sayısı olarak ayarlanır. Bu sınır, tek bir veya küçük bir kullanıcı grubunun günlük kotanızı tüketmesini engelleyecek şekilde tüm kullanıcılara makul erişim sağlamaya devam edecek şekilde yapılandırılmalıdır. Bu sınırları yapılandırmak için API Kullanımını Sınırlama bölümüne bakın. |
Eksponansiyel geri yükleme
İstekler başarısız olduğunda, eksponansiyel geri yükleme seçeneğiyle istekleri yeniden denemeniz gerekir. Örneğin, bir istek bir kez başarısız olursa bir saniye sonra tekrar denerseniz tekrar başarısız olursa iki saniye sonra dört saniye sonra tekrar deneyin. Bu, birçok istemcinin istekleri çok hızlı bir şekilde yeniden denemeye çalıştığı için bozuk isteklerin veya geniş çaplı hataların Google sunucularını boğmamasını sağlar.
Sorun giderme ile ilgili SSS
Uygulama sorunları
- Aracımın konumuna hangi sıklıkta örnek vermeliyim?
- Her 1-10 saniyede bir, yüksek kaliteli geçme videoları için tavsiye edilir.
- Sorgu başına gönderebileceğim puan sayısıyla ilgili bir sınırlama var mıdır?
- Evet, bir sorguda en fazla 100 nokta olabilir.
- Tutulan enlem/boylam çiftlerimi depolamak için hangi hassasiyet düzeyini kullanmalıyım?
- Takılmış yolların maksimum yakınlaştırma düzeyinde bile tüm yakınlaştırma düzeylerinde ilerlemesini sağlamak için, tutturulan enlem/boylam çiftlerini hassaslık açısından 7 ondalık basamakta depolamanız gerekir.
- Tutturulmuş yolları görüntülemek için kodlanmış çoklu çizgileri kullanabilir miyim?
- Kodlanmış politik çizgiler yalnızca 5 ondalık basamaklık bir kesinlikte belirlenir ve bu da yaklaşık 2 metrelik bir hataya neden olur. Dolayısıyla, sabitlenmiş yollarınızın yolu yüksek yakınlaştırma düzeylerinde izlemesini istiyorsanız kodlanan çoklu çizgiler uygun değildir.
Genel sorunlar
- Bazı noktalar alınmamış veya yan yollarda boşluk var. Bunu nasıl düzeltebilirim?
-
- Örneklerinizi, zamanlanmış aralıklarda örnekliyorsanız daha kısa aralıklarla (1-10 saniye arasında) örneklendiğinden emin olun. Daha uzun bir aralık kullanılırsa (örneğin, 60 saniye) tutturma algoritması, yolculuk edilen yolların doğruluğunun yeterli olup olmadığını belirleyemeyebilir.
- Nokta oluşturmak için bir haritayı manuel olarak tıklarsanız birkaç nokta veya seyrek noktalar içeren yollar oluşturmak, tutturma algoritmasının iyi çalışmadığı anlamına gelir. Tutturma algoritması, birbirine yakın olan noktalarda en iyi sonucu verir. Yollara Hızlı Geçiş demosunu deneyin veya yollarınızı test etmek için Yollar denetleyicisini kullanın.
- Yakınlaştırdığımda neden saptığım yollar sapabiliyor veya neden yolun dışına çıkabiliyor?
-
- Gösterilen enlem/boylam çiftlerinin hassasiyetini, görüntülemeden önce kesiyor musunuz? Tutturulan enlem/boylam çiftlerinin 7 ondalık basamaktan daha düşük bir doğrulukla depolanması, haritadaki tutturma yolu görüntülendiğinde hassasiyet hatalarına neden olur.
- Kodlanmış çoklu çizgiler kullanıyor musunuz? Kodlanmış çoklu çizgiler, enlem/boylam çiftlerini 5 ondalık basamağa keserek birkaç metre hata verir. Bu durum, çizgilerin yüksek yakınlaştırma seviyelerinde tırtıklı veya biraz kapalı olmasına neden olur.
Yukarıdaki durumların hiçbiri geçerli değilse harita parçaları yakın zamanda güncellenmiş olabilir. Bu durum, bilgi toplama için kullanılan yol diziniyle senkronize olmadıkları anlamına gelir. Bu durumun nedeni büyük olasılıkla sorgularınızdan yalnızca birkaçının etkilenmiş olmasıdır. Google Haritalar düzenli olarak güncellendiği için bu durum nadiren meydana gelebilir ve haritadaki eski yollara (örneğin, birkaç hafta önce alınan yollar) düzenli olarak baktığınızda daha sık gerçekleşebilir. Optimum görselleştirme için, harita yolları ile veri toplama için kullanılan yol dizini arasındaki tutarsızlıkları en aza indirmek üzere eski yolları harita üzerinde göstermeden hemen önce yeniden yakalamanız gerekir.
- X yolunun hız sınırının yanlış gösterilmesine neden ne olabilir?
- Hız sınırları, doğruluk ve kapsam açısından farklılık gösteren çeşitli kaynaklardan gelir.
Belirli bir yol türüne ilişkin hız sınırları veya belirli bir bölgedeki sürekli olarak yanlış kullanım gibi bir kalıp görürseniz lütfen aşağıdaki adımları uygulayarak bize bildirin:
- Google Haritalar'ı masaüstü bilgisayarınızda VEYA Android için Google Haritalar uygulamasını açın.
- Sol taraftaki 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.
- Sonraki'yi seçin.
- "Diğer" alanında, söz konusu yol için hız sınırının yanlış olduğunu belirtin.
- Gönder'i seçin.
- Takılan yolum neden 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 yakın aralıklarla (1-10 saniyede bir) örneklendiğini kontrol edin.
- Hız sınırı değişiklikleri olmadan bir yol için neden sıkışmış yolda çok sayıda yol segmenti döndürülüyor?
interpolate
parametresitrue
değerine ayarlandığında, kenara hizala sorgusu, köşeler, eğriler ve kavşağın çevresindeki yolu izleyen bir çoklu çizgi döndürür. Yol kavisliyse, yol geometrisini yakından takip eden bir çoklu çizgi oluşturmak için hız sınırı değişmese bile birden fazla yol segmenti döndürülür.