Hataları işleme

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

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

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

Hata girişi

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

required

İsteğinizde 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 düzeyi, söz konusu harita karosuna ve istediğiniz harita seçeneklerine bağlıdır.

• Normal harita karoları için x koordinatı [0, (2^zoom)-1] aralığında olmalıdır.

• Normal harita parçaları için y koordinatı [0, (2^(yakınlaştırma-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 karolarında, beşinci yakınlaştırma düzeyine kadar x ve y koordinat aralıkları normal harita karolarıyla aynıdır. Bu noktada maksimum değerler, imageHeight veya imagewidth'ın tileHeight veya tileWidth'e bölümüdür.

forbidden: İstekte geçerli bir API anahtarı eksik.

expired

session jetonunuzun süresi doldu. Oturum jetonu, oluşturulduğu tarihten itibaren iki hafta boyunca geçerlidir. Bu sürenin ö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 nedenlerinden bazıları şunlardır:

• roadmap katmanı eklemeden terrain harita türü belirttiniz.

• Yol haritası haritası türü olmayan bir styles dizisi eklediniz.

• Street View meta veri isteğinde bir enlem/boylam değeri ve panorama kimliği gönderdiniz.

quotaExceeded, rateLimitExceeded

Uygulamanız izin verilen kotasını veya saniye başına izin verilen 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, birçok istemcinin istekleri kısa süre içinde tekrar denemeye çalıştığından, bozuk isteklerin veya geniş ölçekli hataların Google sunucularını aşırı yüklememesi için isteğinizi yeniden denemelisiniz. Bu, isteklerinizi yeniden denediğinizde eksponansiyel geri yükleme kullanmanız anlamına gelir. Üretken geri çekilme, sunucunun toparlanması için zaman tanımak amacıyla isteklerinizi zaman içinde dağıtmaya zorlar.

Ö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, aralarındaki süreyi ikiye katlayarak her bir art arda gelen isteği etkili bir şekilde dağıtabilirsiniz.

3D Parçalar

Google'ın sunucusundan gelen hatalar, sunucu hatalarını işlemekten sorumlu bir oluşturma aracı aracılığıyla fotogerçekçi karolara eriştiğiniz için sizin için açık olmayabilir.

Karo oluşturma hataları

Örneğin, CesiumJS oluşturma aracı 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 türlü soruna neden olabilir.

Sunucu hatalarını gidermek için kullandığınız teknik, kullandığınız oluşturma aracına bağlıdır. CesiumJS gibi tarayıcı tabanlı oluşturma araçları için çoğu tarayıcıda yerleşik olan araçlarla ağ trafiğini inceleyebilirsiniz. Örneğin, Chrome Geliştirici Araçları'nı kullanabilirsiniz.

Yaygın görülen 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ş oturum jetonu.

403: İzin reddedildi

API anahtarı eksik, SSL bağlantısı eksik veya API anahtarınız 3D Karolar için izin verilenler listesine eklenmedi. Harita Karoları API'sinin 3D Karolar işlevi için izin verilenler listesine eklenmek üzere proje kimliğinizle Google Destek Ekibi ile iletişime geçin.

429: Çok fazla istek

Kotanız tükendi. Kotanızı artırmak için Google Destek Ekibi ile iletişime geçin.