Sorun giderme

Hatalar

Hata 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 nesnesi içeren bir nesne içerir:

  • code: Bu, yanıtın HTTP durumuyla aynıdır.
  • message: Hatanın kısa açıklaması.
  • status: Hatanın niteliğini belirten bir durum kodu.

Örneğin, geçersiz bir placeId parametresi gönderdiğinizde 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 edilmemiş. 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.
    Lütfen en az 1 ve en fazla 100 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ğiniz geçersiz bir placeId içeriyordu.
  • İ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ıtsız istek engellendi. Lütfen Google Developers Console'u kullanarak kaydolun. İstek aşağıdakilerden biri veya daha fazlası nedeniyle reddedildi:
  • API anahtarı eksik veya geçersiz.
  • Hesabınızda faturalandırma etkinleştirilmedi.
  • Kendi belirlediğiniz kullanım sınırı aşıldı.
  • Sağlanan ödeme yöntemi artık geçerli değilse (ör. kredi kartının süresi dolmuşsa).

Google Haritalar Platformu ürünlerini kullanmak için hesabınızda faturalandırmanın etkinleştirilmesi ve tüm isteklerin geçerli bir API anahtarı içermesi gerekir. Bu sorunu düzeltmek için aşağıdaki adımları uygulayın:

404 NOT_FOUND Bu hizmet için HTTPS gereklidir. İstekleri http://roads.googleapis.com/ yerine https://roads.googleapis.com/ adresine gönderdiğinizden emin olun.
429 RESOURCE_EXHAUSTED Proje isteği sınırlarına ulaşıldığından istek sınırlandı. 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 saniyelik istek sayısı ve kullanıcı başına 100 saniyelik 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ı doldurmasını engelleyecek şekilde yapılandırılmalıdır. Bu sayede, tüm kullanıcılara makul bir erişim izni verilebilir. Bu sınırları yapılandırmak için API Kullanımını Sınırlama'ya bakın.

Eksponansiyel geri yükleme

İstekler başarısız olduğunda, istekleri üstel geri yüklemeyle yeniden denediğinizden emin olmanız gerekir. Örneğin, bir istek bir kez başarısız olursa bir saniye sonra tekrar deneyin. Tekrar başarısız olursa iki saniye sonra, ardından dört saniye sonra tekrar deneyin. Bu sayede, birçok istemci istekleri çok hızlı bir şekilde yeniden denemeye çalıştığından bozuk isteklerin veya geniş ölçekli hataların Google'ın sunucularını tıkaması önlenir.

Sorun Giderme ile İlgili SSS

Uygulama sorunları

Araç konumumu hangi sıklıkta örneklemeliyim?
Yüksek kaliteli yol görüntüleme sonuçları için 1-10 saniyede bir görüntüleme yapılması önerilir.
Sorgu başına gönderebileceğim puan sayısı sınırlı mı?
Evet, bir sorgu en fazla 100 puan içerebilir.
Kırpılan enlem/boylam çiftlerimi depolamak için hangi hassasiyet düzeyini kullanmalıyım?
Sabitlenmiş 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 sabitlenmiş enlem/boylam çiftlerinizi 7 ondalık basamak hassasiyetle saklamanız gerekir.
Sabitlenmiş yolları görüntülemek için kodlanmış çoklu çizgileri kullanabilir miyim?
Kodlanmış çok çizgiler yalnızca 5 ondalık basamak hassasiyetinde belirtilir. Bu da yaklaşık 2 metrelik bir hataya neden olur. Bu nedenle, sabitlenmiş yollarınızın yüksek yakınlaştırma düzeylerinde yolu takip etmesini istiyorsanız kodlanmış çok çizgiler uygun değildir.

Genel sorunlar

Bazı noktalar sabitlenmiyor veya sabitlenen yollarda boşluklar var. Bu sorunu nasıl düzeltebilirim?
  • Puanlarınızı zamanlı aralıklarla örnekliyorsanız puanlarınızın daha kısa aralıklarla (1-10 saniyede bir) örneklendiğinden emin olun. Daha uzun bir aralık (ör. 60 saniye) kullanılırsa yola yaklaşma algoritması, gidilen yolları yeterince doğru belirleyemeyebilir.
  • Nokta oluşturmak için haritayı manuel olarak tıklıyorsanız, çakışma algoritmasının iyi işleyemediği, az sayıda nokta veya seyrek nokta içeren yollar oluşturmak çok kolaydır. Otomatik ekleme algoritması, birbirine yakın noktalarda en iyi sonucu verir. Yollara hizalama özelliğini test etmek için Yollarda hizalama demo sürümünü deneyin veya Yol denetçisini kullanın.
Yakınlaştırdığımda neden sabitlenmiş yollarım sivri uçlu veya yoldan biraz uzak görünüyor?
  • Kırpılan enlem/boylam çiftlerinin hassasiyetini görüntülemeden önce mi kısaltıyorsunuz? Sabitlenmiş enlem/boylam çiftlerinin 7 ondalık basamaktan daha düşük bir hassasiyetle saklanması, sabitlenmiş yol haritada görüntülendiğinde hassasiyet hatalarına neden olur.
  • Kodlanmış çoklu çizgiler mi kullanıyorsunuz? Kodlanmış çoklu çizgiler, enlem/boylam çiftlerini 5 ondalık basamakla keser. Bu da birkaç metrelik bir hata oluşturur. Sonuç olarak, yüksek yakınlaştırma düzeylerinde çizgiler sivri uçlu olur veya yoldan biraz sapmış görünür.

Yukarıdakilerden hiçbiri geçerli değilse harita karoları yakın zamanda güncellenmiş olabilir. Bu da, karoların sabitleme için kullanılan yol dizini ile senkronize olmamasına neden olur. Sorgularınızdan yalnızca birkaçı etkileniyorsa bunun nedeni büyük olasılıkla budur. Google Haritalar düzenli olarak güncellendiğinden bu durum zaman zaman ortaya çıkabilir. Haritadaki eski yollara (ör. birkaç hafta önce çekilen yollar) düzenli olarak bakarsanız bu durum daha sık ortaya çıkabilir. En iyi görselleştirme için harita karoları ile yakalama için kullanılan yol dizini arasındaki tutarsızlıkları en aza indirmek amacıyla eski yolları harita üzerinde göstermeden hemen önce yeniden yakalamanız gerekir.

X yolunun hız sınırının yanlış gösterilmesine ne sebep olabilir?
Hız sınırları, doğruluk ve kapsam açısından çeşitli kaynaklardan gelir. Belirli bir yol türünün veya belirli bir alandaki hız sınırlarının sürekli olarak yanlış olduğu gibi bir kalıp görürseniz lütfen bize bildirmek için aşağıdaki adımları uygulayın:
  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üzenleyin'i seçin.
  5. Düzenlemek istediğiniz yol segmentini seçin.
  6. İleri'yi seçin.
  7. "Diğer" alanında, söz konusu yol için hız sınırının yanlış olduğunu belirtin.
  8. Gönder'i seçin.
Burada diğer sorunları da bildirebilirsiniz (örneğin, yolun adı yanlışsa, yanlış çizilmişse, kapalıysa veya özelse).
Sabitlenmiş yolum neden 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 yakın aralıklarla (1-10 saniyede bir) örneklendiğini kontrol edin.
Hız sınırı değişikliği olmayan bir yol için neden sabitlenmiş yolda çok sayıda yol segmenti döndürülüyor?
interpolate parametresi true olarak ayarlandığında, yola yaklaşma sorgusu, köşeleri, virajları ve dönen kavşakları takip eden bir çoklu çizgi döndürür. Yol virajlıysa hız sınırı değişmese bile yol geometrisine yakın bir poli çizgisi oluşturmak için birden fazla yol segmenti döndürülür.