Aralık ayında San Francisco'da düzenlenecek bir sonraki Google Haritalar Platformu Geliştirici Topluluğu Günü'nde bize katılın. Katılmak için hemen başvurun.

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ı'ndaki (AEA) geliştiriciler

İstek gönderdikten 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 Tiles ve Street View görüntülerini kullanırken karşılaşabileceğiniz hatalar ayrıntılı olarak açıklanmıştır.

Hata listesi

Aşağıdaki listede, Map Tiles API'yi kullanırken karşılaşabileceğiniz hatalar ayrıntılı olarak açıklanmıştır.

required

İsteğinizde bir URL parametresi eksik. Hata mesajında hangi parametrenin eksik olduğu belirtilir.

notFound, invalid

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

Normal harita karoları için maksimum yakınlaştırma seviyesi, belirli harita karosuna ve istediğiniz harita seçeneklerine bağlıdır.
Normal harita karoları için x koordinatı [0, (2^yakınlaştırma)-1] aralığında olmalıdır.
Normal harita karoları için y koordinatı [0, (2^(zoom-1))-1] aralığında olmalıdır.
Street View karoları için yakınlaştırma 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'in tileHeight ya da tileWidth'e bölünmesiyle elde edilir.

forbidden:

Olası nedenler:

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

2D uydu karoları, Avrupa Ekonomik Alanı (AEA) adresi olan bir faturalandırma hesabına bağlı projelerde kullanılamaz. Daha fazla bilgi için AEA müşterileri için Map Tiles API düzenlemeleri başlıklı makaleyi inceleyin.

expired

session jetonunuzun süresi doldu. Oturum jetonu, oluşturulduğu tarihten itibaren iki hafta boyunca geçerlidir. Bu durumun önceden haber verilmeksizin değişebileceğini unutmayın. Bu hatayı alırsanız Oturum jetonlarını kullanma bölümünde açıklandığı gibi yeni bir oturum jetonu almanız gerekir.

badRequest

İsteğinizin yapısı bozuktu. Bunun yaygın nedenleri arasında şunlar yer alır:

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

quotaExceeded, rateLimitExceeded

Uygulamanız izin verilen kotasını veya saniyedeki sorgu sayısını aştı.

Ö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 denemeniz gerekir. Birçok istemci, istekleri hızlı bir şekilde yeniden denemeye çalışır. Bu, isteklerinizi yeniden denerken eksponansiyel geri yükleme kullanmanız gerektiği anlamına gelir. Eksponansiyel geri yükleme, isteklerinizi zamana yayarak sunucuya toparlanması için zaman tanır.

Örneğin, bir istek başarısız olursa bir saniye sonra tekrar deneyin. Ancak bu deneme de başarısız olursa isteğinizi iki saniye sonra tekrar deneyin. Bu istek de başarısız olursa dört saniye sonra tekrar deneyin. Böylece, her bir isteğin arasındaki süreyi iki katına çıkararak istekleri etkili bir şekilde yaymış olursunuz.

3D Tiles

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

Karo oluşturucu hataları

Örneğin, CesiumJS oluşturucu genellikle sunucu hataları oluştuğunda sessizce başarısız olur. Bu durum, kilitlenmelerden boş ekranlara ve belirli karoların yüklenmemesine kadar her şeye neden olabilir.

Sunucu hatalarını ayıklamak için kullanacağınız teknik, kullandığınız 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, karo/karo grubu kimlikleri veya süresi dolmuş bir oturum jetonu.
400: Geçersiz Değer: createSessionToken isteğinin yapıldığı mapType'ın, sonraki karo uç noktasında kullanılan mapType ile eşleştiğinden emin olun. Örneğin, streetview oturum jetonu, roadmap karosu istemek için kullanılamaz.

403: İzin reddedildi