Sorun giderme

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ıt, aşağıdaki anahtarlara sahip tek bir error nesnesi içeren bir nesne içerir:

  • code: Bu, yanıtın HTTP durumuyla aynıdır.
  • message: Hatanın kısa açıklamasıdır.
  • status: Hatanın niteliğini 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:
  • path parametrenizle ilgili bir sorun var.
    Lütfen en az 1, en fazla 99 puanınız olduğundan emin olun. Her nokta, virgülle ayrılmış bir sayı çifti olmalıdır. Örneğin: 48.409114,-123.369158. Puanlar dikey çizgiyle: "|" ayrılmalıdır.
  • İsteğinizde geçersiz bir placeId vardı.
  • İsteğiniz hem placeId hem de path içeriyordu. Her istek için bu parametrelerden yalnızca biri belirtilebilir.

Artık mevcut olmayan bir yol veya yol olmayan bir yer için placeId iletilirse bu hata döndürülmez.
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:
  • API anahtarı eksik veya geçersiz.
  • Hesabınızda faturalandırma etkinleştirilmemiştir.
  • Kendiniz belirlediğiniz kullanım sınırı aşıldı.
  • Belirtilen ödeme yöntemi artık geçerli değil (örneğin, kredi kartının süresi dolmuş).

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 istek 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. Ancak tüm kullanıcıların makul düzeyde erişimine izin verilmeye devam edilmelidir. 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?
Yola tutturma özelliğinin yüksek kaliteli sonuçlar vermesi 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.
Çekilen enlem/boylam çiftlerimi depolamak için hangi kesinlik düzeyini kullanmalıyım?
Çizilen 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 çizilen enlem/boylam çiftlerinizi 7 ondalık basamak hassasiyetinde saklamanız gerekir.
Tutulan 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 seviyelerinde yolu takip etmesini istiyorsanız kodlanmış çoklu çizgiler uygun değildir.

Genel sorunlar

Bazı noktalar tutturulmuyor veya tutturulmuş 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 (her 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 rotalarınızı test etmek için Yol inceleyiciyi kullanın.
Yakınlaştırdığımda tutturulan yollarım 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ıdakilerden hiçbiri geçerli 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, harita döşemeleri ile sabitleme için kullanılan yol indeksi arasındaki tutarsızlıkları en aza indirmek amacıyla eski yolları haritada göstermeden hemen önce yeniden sabitlemeniz gerekir.

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. Örneğin, belirli bir yol türü veya belirli bir alandaki hız sınırlarının sürekli olarak yanlış olduğunu fark ederseniz lütfen aşağıdaki adımları uygulayarak bize bildirin:
  1. Masaüstü bilgisayarınızda Google Haritalar'ı VEYA Android için Google Haritalar uygulamasını açın.
  2. Sol taraftaki menüyü açın.
  3. Geri bildirim gönder'i seçin. Not: Giriş yapmanız istenebilir.
  4. Haritayı düzenle'yi seçin.
  5. Düzenlemek istediğiniz yol segmentini seçin.
  6. Sonraki'yi seçin.
  7. "Diğer" alanında, hız sınırının söz konusu yol için yanlış olduğunu belirtin.
  8. Gönder'i seçin.
Buradan başka sorunları da bildirebilirsiniz (ör. yolun adı yanlışsa, yanlış çizilmişse, kapalıysa veya özel mülkse).
Neden tutturulan rotam yolu takip etmek yerine köşeleri kesiyor?
Bu sorunu düzeltmek için aşağıdakileri kontrol edin:
  • interpolate parametresinin true 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 parametresi true olarak ayarlandığında, yola tutturma sorgusu, köşeler, virajlar ve kavşaklar etrafındaki yolu takip eden bir çoklu çizgi döndürür. Yol kıvrılıyorsa 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.