Sorun giderme

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Hatalar

Bir hata olması durumunda, standart biçimli 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 olan bir nesne var:

  • code: Bu, yanıtın HTTP durumuyla 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 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ı 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çeriyor. Bu hatanın en olası nedenleri şunlardır:
  • path parametresiyle 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 çift sayı olmalıdır. Örneğin, 48.409114,-123.369158. Noktalar bir dikey çizgiyle ayrılmalıdır: "|".
  • İsteğiniz geçersiz bir placeId içeriyor.
  • İsteğinizde hem placeId hem de path bulunuyordu. Her istek için bu parametrelerden yalnızca bir tanesi belirtilebilir.

Artık mevcut olmayan bir yol veya yol olmayan bir yer için placeId aktarılırsa bu hata döndürülmez.

403 PERMISSION_DENIED Kayıtlı olmayan istek engellendi. Lütfen Google Developers Console'u kullanarak kaydolun. Aşağıdakilerden biri veya daha fazlası nedeniyle istek reddedildi:
  • API anahtarı eksik veya geçersiz.
  • Hesabınızda faturalandırma etkinleştirilmedi.
  • Kendi kendini sınırlayan bir kullanım sınırı aşıldı.
  • Sağlanan ödeme yöntemi artık geçerli değil (örneğin, kredi kartının geçerlilik süresi dolmuş).

Google Haritalar Platformu ürünlerini kullanabilmek için hesabınızda faturalandırmanın etkin 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 gereklidir. İstekleri http://roads.googleapis.com/ ile değil, https://roads.googleapis.com/ ile gönderdiğinizden emin olun.
429 RESOURCE_EXHAUSTED Proje istek sınırlarına ulaşılması nedeniyle 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. Tüm kullanıcılar için makul erişim düzeyini korurken tek veya küçük bir kullanıcı grubunun günlük kotanızı tüketmesini önleyecek şekilde bu sınır yapılandırılmalıdır. Bu sınırları yapılandırmak için Caption API Kullanımını Sınırlama bölümüne bakın.

Eksponansiyel geri yükleme

İstekler başarısız olursa istekleri eksponansiyel geri yükleme ile tekrar denediğinizden emin olmanız gerekir. Örneğin, bir istek bir kez başarısız olursa bir saniye sonra tekrar denenirse başarısız olursa iki saniye sonra tekrar dört saniye sonra tekrar deneyin. Birçok istemci, istekleri çok hızlı bir şekilde yeniden denemeye çalıştığı için bozuk isteklerin veya geniş ölçekli hataların Google sunucularını sellememesini sağlar.

Sorun giderme ile ilgili SSS

Uygulama sorunları

Araç konumumu ne sıklıkta kullanmalıyım?
Kaliteli arazi aracı sonuçları için 1-10 saniyede bir önerilir.
Sorgu başına gönderebileceğim puan sayısıyla ilgili bir sınırlama var mı?
Evet, bir sorguda en fazla 100 nokta olabilir.
Tutturulan enlem/boylam çiftlerimi depolamak için hangi kesinlik düzeyini kullanmalıyım?
Yakıtılmış yolların, en yüksek yakınlaştırma düzeyinde bile tüm yakınlaştırma seviyelerinde yolları gösterdiğinden emin olmak için, tutturulan enlem/boylam çiftlerini 7 ondalık hassasiyet konumunda saklamanız gerekir.
Takılı yolları görüntülemek için kodlanmış çoklu çizgileri kullanabilir miyim?
Kodlanan çoklu çizgi çizgileri yalnızca 5 ondalık basamak hassasiyetiyle belirtilir ve yaklaşık 2 metre hata verir. Dolayısıyla, sabitlenmiş yollarınızın yolu yüksek yakınlaştırma düzeylerinde izlemesini istiyorsanız kodlanan çoklu çizgiler için uygun değildir.

Genel sorunlar

Bazı noktalar takılmamış veya klip yollarında boşluklar var. Bunu nasıl düzeltebilirim?
  • Puanlarınızı zamanlanmış aralıklarda kullanıyorsanız, noktaların daha kısa aralıklarla (1-10 saniyede bir) örneklendiğinden emin olun. Daha uzun bir aralık (örneğin, 60 saniye) kullanılırsa yola hizalama algoritması, yeterince doğru seyahat edilen yolları belirleyemeyebilir.
  • Nokta oluşturmak için bir haritayı manuel olarak tıklarsanız birkaç nokta veya seyrek nokta içeren yolları oluşturmak, yapışma algoritmasının iyi çalışmadığı anlamına gelir. Yapışma algoritması en iyi sonucu, birbirine yakın noktalarda verir. Yollara Hızlı Geçiş demosunu deneyin veya yollarınızı test etmek için Yollar denetçisini kullanın.
Görüntüyü yakınlaştırdığımda neden sıkışmış yollarım titriyor veya yoldan biraz uzaklaşıyor?
  • Tutulan enlem/boylam çiftlerinin hassasiyetini, görüntülemeden önce kısaltıyor musunuz? Tutturulan enlem/boylam çiftlerinin 7 ondalık basamaktan daha düşük bir doğrulukla saklanması, haritada gizli yolda 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 keser ve bu da birkaç metre hata mesajı verir. Bu da çizgilerin yüksek yakınlaştırma seviyelerinde pürüzlü veya çok dar olmasına neden olur.

Yukarıdaki durumların her ikisi de geçerli değilse harita parçaları yakın zamanda güncellenmiş olabilir. Bu da, karoların verim almak için kullanılan yol diziniyle senkronize olmamalarına yol açmış olabilir. Bunun nedeni, yalnızca birkaç sorgunuzdan etkileniyorsa sorun olabilir. Google Haritalar düzenli olarak güncellendiği için bu durum, zaman zaman ortaya çıkabilir ve düzenli olarak bir haritadaki eski yollara (örneğin, birkaç hafta önce tutturulan yollara) baktığınızda daha sık gerçekleşebilir. Optimum görselleştirme için, harita parçaları ile deneme için kullanılan yol dizini arasındaki tutarsızlıkları en aza indirmek amacıyla eski yolları haritada göstermeden hemen önce yeniden ele almanız gerekir.

X yolunun hız sınırı neden yanlış görüntüleniyor?
Hız sınırları, doğruluk ve kapsam açısından farklılık gösteren çeşitli kaynaklardan gelmektedir. Örneğin, belirli bir yol türü için veya belirli bir bölgedeki hız sınırlarının sürekli yanlış olması durumunda bir kalıp görürseniz bize bildirmek için lütfen 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 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.
Ayrıca başka sorunları da (ör. yolun adı yanlışsa, yanlış çizilmiş veya kapalı ya da özel) bildirebilirsiniz.
Tuttuğum yol neden yolu izlemek 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ın yeterince yakın aralıklarla (1-10 saniyede bir) örneklendiğini kontrol edin.
Hız sınırında değişiklik olmadan, dar bir yol için neden çok sayıda yol segmenti döndürülüyor?
interpolate parametresi true değerine ayarlandığında yapışma sorgusu, köşeler, kıvrımlar ve döner kavşakları çevreleyen yolu izleyen bir çoklu çizgi döndürür. Yolun eğri olması, 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 segmentinin döndürülmesini sağlar.