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ı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:
  • 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 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:
  1. Masaüstü bilgisayarınızda Google Haritalar'ı VEYA Android için Google Haritalar uygulamasını açın.
  2. Soldaki yan menüyü açın.
  3. Geri bildirim gönder'i seçin. Not: Giriş yapmanız istenebilir.
  4. Haritayı düzenleyin'i seçin.
  5. Düzenlemek istediğiniz yol segmentini seçin.
  6. İleri'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.
Diğer sorunları da buradan 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ı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.