Sorun giderme

Hatalar

Hata olması 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 nesnesine sahip nesne içerir:

  • code: Bu, yanıtın HTTP durumu ile aynıdır.
  • message: Hatanın kısa bir açıklaması.
  • status: Hatanın yapısını belirten bir durum kodu.

Örneğin, geçersiz bir placeId parametresi göndermek aşağıdaki hatayı döndürü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ı dahil ettiğ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 ve 100'den az 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. Noktalar bir 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 geçirilirse 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ğıdakilerden biri veya daha fazlası nedeniyle reddedildi:
  • API anahtarı eksik veya geçersiz.
  • Hesabınızda faturalandırma etkinleştirilmemiştir.
  • Kullanım sınırı aşıldı.
  • Sağlanan ödeme yöntemi artık geçerli değil (örneğin, bir kredi kartının geçerlilik süresi sona ermiş).

Google Haritalar Platformu ürünlerini kullanabilmeniz 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 Bu istek, proje isteği sınırlarına ulaşıldığından 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, 100 saniye başına istek ve kullanıcı başına 100 saniye başına istek şeklinde belirlenir. Bu sınır, tüm kullanıcılar için makul erişim izni verirken bir yandan veya küçük bir kullanıcı grubunun günlük kotanızı tüketmesini önleyecek ş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, istekleri eksponansiyel geri yükleme ile yeniden denediğinizden emin olmalısınız. Örneğin, bir istek bir kez başarısız olursa bir saniye sonra tekrar deneyin. Tekrar başarısız olursa iki saniye, ardından dört saniye sonra tekrar deneyin. Birçok istemci istekleri çok hızlı bir şekilde yeniden denemeye çalıştığından bu işlem, bozuk isteklerin veya geniş ölçekli hataların Google'ın sunucularını doldurmamasını sağlar.

Sorun Giderme SSS

Uygulama sorunları

Aracımın konumunu hangi sıklıkta örneklemeliyim?
1-10 saniyede bir, yüksek kaliteli hızlı geçiş sonuçları elde etmek için önerilir.
Sorgu başına gönderebileceğim puan sayısı sınırlı mıdır?
Evet, bir sorgu en fazla 100 puan içerebilir.
Yakalanan enlem/boylam çiftlerimi depolamak 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 ettiğinden emin olmak için, yakalanan enlem/boylam çiftlerini 7 ondalık basamak hassasiyetinde saklamanız gerekir.
Tutulan yolları görüntülemek için kodlanmış çoklu çizgileri kullanabilir miyim?
Kodlanmış çoklu çizgiler, yalnızca 5 ondalık basamak hassasiyetiyle belirtilir. Bu durumda, yaklaşık 2 metrelik bir hata oluşur. Dolayısıyla, kodlanmış çoklu çizgiler, yakalanan yollarınızın yolu yüksek yakınlaştırma düzeylerinde izlemesini istediğinizde uygun değildir.

Genel sorunlar

Bazı noktalar tutturulmuyor veya tutturulan yollarımda boşluklar var. Bunu nasıl düzeltebilirim?
  • Noktalarınızı zamanlanmış aralıklarda ö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 (ör. 60 saniye) yola çık algoritması, yeterli doğrulukla gidilen yolları belirleyemeyebilir.
  • Nokta oluşturmak için haritayı manuel olarak tıklıyorsanız yapışma algoritmasının iyi işlem yapamadığı az sayıda noktası veya seyrek noktası olan yollar oluşturmak çok kolaydır. Tutturma algoritması, birbirine yakın noktalarda en iyi sonucu verir. Yollara Geçiş demosunu deneyin veya yollarınızı test etmek için Yollar denetleyicisini kullanın.
Yakınlaştırdığımda, kesilmiş yollarım neden titriyor veya yoldan biraz uzaklaşıyor?
  • Tuttuğunuz enlem/boylam çiftlerinin kesinliğini göstermeden önce kesiyor musunuz? Tutulan enlem/boylam çiftlerinin, 7 ondalık basamaktan daha az bir doğrulukla depolanması, eklenen yol harita üzerinde 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 basamak olacak şekilde kısaltır. Bu da birkaç metre hataya neden olur. Bu da, yüksek yakınlaştırma düzeylerinde yoldan pürüzlü veya biraz sapmaya yol açar.

Yukarıdakilerin hiçbiri geçerli değilse harita desenleri kısa bir süre önce güncellenmiş ve bu nedenle, birleştirme işlemi için kullanılan yol diziniyle senkronizasyonu bozulmuş olabilir. Sorgularınızın yalnızca birkaçı etkileniyorsa nedeni büyük olasılıkla budur. Google Haritalar düzenli olarak güncellendiğinden bu durum zaman zaman yaşanabilir ve bir harita üzerinde düzenli olarak eski yollara (örneğin, birkaç hafta önce çekilmiş yollar) bakarsanız daha sık gerçekleşebilir. En iyi görselleştirme için, eski yolları harita üzerinde göstermeden hemen önce yeniden yakalamanız gerekir. Bu sayede, harita parçaları ile tutturma için kullanılan yol dizini arasındaki tutarsızlıkları en aza indirirsiniz.

X yolu için hız sınırının yanlış görüntülenmesinin nedeni ne olabilir?
Hız sınırları, doğruluk ve kapsam açısından farklılık gösteren çeşitli kaynaklardan gelmektedir. Belirli bir yol türü için hız sınırları gibi veya belirli bir bölgede sürekli yanlış olan bir kalıp tespit ederseniz lütfen aşağıdaki adımları uygulayarak bizi bilgilendirin:
  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.
Diğer sorunları da buradan bildirebilirsiniz (örneğin, yolun adı yanlışsa, yanlış çizilmiş, kapalı veya özelse).
Kesilen yolum neden yolu takip etmek yerine kırılıyor?
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ğinden emin olun.
Neden hız sınırı değişikliği yapılmadan bir yola ait kesikli yolda çok sayıda yol segmenti alıyorum?
interpolate parametresi true olarak ayarlandığında, tutturma sorgusu köşeleri, dönemeçleri ve döner kavşakları takip eden yolu izleyen bir çoklu çizgi döndürür. Yol kavisli olursa yol geometrisine yakın 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.