Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Hataları işleme

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Talepte bulunduktan sonra, hata ayrıntılarını içeren bir yanıt alabilirsiniz.

2B parçalar ve Street View görüntüleri

Aşağıdaki listede, 2D döşemeler ve Street View görüntülerini kullanırken karşılaşabileceğiniz hatalar ayrıntılı olarak açıklanmaktadır.

Hata listeleme

Aşağıdaki listede, Harita Döşemeleri API'sini kullanırken karşılaşabileceğiniz hatalar ayrıntılı olarak açıklanmaktadır.

required

İsteğinizde bir URL parametresi eksik. Hata mesajında hangi parametrenin eksik olduğunun belirtildiğini unutmayın.

notFound, invalid

x, y veya z değerleriniz aralık dışında.

Normal harita karolarında maksimum yakınlaştırma seviyesi, söz konusu harita karosuna ve istediğiniz harita seçeneklerine bağlıdır.
Normal harita döşemeleri için x koordinatı [0, (2^zoom)-1] aralığında olmalıdır.
Normal harita döşemeleri için y koordinatı [0, (2^(zoom-1))-1] aralığında olmalıdır.
Street View döşemeleri için yakınlaştırma değeri sıfır ile beş arasında (bu değerler dahil) olmalıdır.
Street View parçaları için x ve y koordinat aralıkları, beşinci seviye yakınlaştırmaya kadar normal harita parçalarıyla aynıdır. Bu noktada, maksimum değerler imageHeight veya imagewidth bölü tileHeight veya tileWidth olur.

forbidden:

Olası nedenler:

İstek geçerli bir API anahtarı içermiyor.
Mesaj: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

2D uydu döşemeleri, Avrupa Ekonomik Alanı (AEA) adresli bir faturalandırma hesabına bağlı projelerde kullanılamaz. Daha fazla bilgi için AEA'daki müşteriler için Map Tiles API'de yapılan düzenlemeler başlıklı makaleyi inceleyin.

expired

sessionJetonunuzun süresi doldu. Oturum jetonunun geçerlilik süresi, oluşturulma zamanından itibaren iki haftadır. Bu durumun bildirimde bulunulmaksızın değişebileceğini unutmayın. Bu hatayı alırsanız Oturum jetonlarını kullanma başlıklı makalede açıklandığı gibi yeni bir oturum jetonu almanız gerekir.

badRequest

İsteğinizin yapısı bozuktu. Bunun yaygın nedenleri şunlardır:

roadmap katmanı eklemeden terrain harita türü belirttiniz.
Yol haritası olmayan bir harita türü için styles dizisi eklediniz.
Bir Street View meta veri isteğinde enlem/boylam değeri ve panorama kimliği gönderdiniz.

quotaExceeded, rateLimitExceeded

Uygulamanız, izin verilen kotayı veya saniyedeki izin verilen sorgu sayısını aşmıştır.

Örnek hata

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

İstekleri yeniden deneme

İstekler quotaExceeded ve rateLimitExceeded ile başarısız olduğunda, bozuk isteklerin veya geniş ölçekli hataların Google sunucularını doldurmaması için isteğinizi yeniden göndermelisiniz. Birçok istemci, istekleri hızlı bir şekilde yeniden göndermeye çalışır. Bu, isteklerinizi yeniden denerken eksponansiyel geri yükleme kullanmanız gerektiği anlamına gelir. Eksponansiyel geri yükleme, sunucuya toparlanması için zaman tanımak amacıyla isteklerinizi zaman içinde yaymanızı zorunlu kılar.

Örneğin, bir istek başarısız olursa bir saniye sonra tekrar deneyin. Ancak bu girişim de başarısız olursa iki saniye sonra isteğinizi tekrar deneyin. Bu istek de başarısız olursa dört saniye sonra tekrar deneyin. Bu nedenle, her bir sonraki isteği aralarındaki süreyi iki katına çıkararak etkili bir şekilde yayabilirsiniz.

3B parçalar

Google'ın sunucusundan kaynaklanan hatalar, sunucu hatalarını işlemekten sorumlu bir oluşturucu aracılığıyla fotogerçekçi döşemelere eriştiğiniz için sizin için belirgin olmayabilir.

Döşeme oluşturucu hataları

Örneğin, sunucu hataları oluştuğunda CesiumJS oluşturucusu genellikle sessizce başarısız olur. Bu durum, kilitlenmelerden boş ekranlara ve belirli döşemelerin yüklenmemesine kadar çeşitli sorunlara yol açabilir.

Sunucu hatalarını ayıklamak için kullandığınız teknik, kullandığınız belirli oluşturucuya bağlıdır. CesiumJS gibi tarayıcı tabanlı oluşturucularda, çoğu tarayıcıda yerleşik olarak bulunan araçlarla ağ trafiğini inceleyebilirsiniz. Örneğin, Chrome Geliştirici Araçları'nı kullanabilirsiniz.

Sık karşılaşılan hatalar

Aşağıdaki listede, karşılaşabileceğiniz en yaygın hatalarla ilgili ayrıntılar yer almaktadır.

400: Geçersiz bağımsız değişken: Geçersiz API anahtarları, sorgu parametreleri, döşeme/döşeme grubu kimlikleri veya süresi dolmuş bir oturum jetonu.
400: Geçersiz Değer: createSessionToken isteğinin yapıldığı mapType'ın, sonraki döşeme uç noktasında kullanılan mapType ile eşleştiğinden emin olun. Örneğin, streetview oturum jetonu, roadmap karo isteğinde bulunmak için kullanılamaz.

403: İzin reddedildi