Hataları işleme

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

2D Karolar 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çıklanmaktadır.

Giriş hatası

Aşağıdaki listede, Map Tiles API'yi 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 desenleri için maksimum yakınlaştırma düzeyi, belirli harita döşemesine ve istediğiniz harita seçeneklerine bağlıdır.

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

  • Normal harita parçaları 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ş (her ikisi de dahil) arasında olmalıdır.

  • Street View Karoları için x ve y koordinat aralıkları, beşinci düzeye zum yapana kadar normal harita döşemeleriyle aynıdır. Bu noktada maksimum değerler, imageHeight veya imagewidth bölü tileHeight ya da tileWidth olur.

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

expired
session jetonunuzun süresi doldu. Bir oturum jetonu, oluşturulma zamanından itibaren iki hafta süreyle geçerlidir. Bunun haber verilmeden 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ğiniz hatalı biçimlendirilmiş. Bunun sık karşılaşılan nedenleri aşağıda belirtilmiştir:

  • 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ğiyle enlem/boylam değerinin yanı sıra bir panorama kimliği gönderdiniz.

quotaExceeded, rateLimitExceeded

Uygulamanız izin verilen kotasını aştı 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"
  }
}

İstekler yeniden deneniyor

İstekler quotaExceeded ve rateLimitExceeded ile başarısız olduğunda, birçok istemci istekleri hızlı bir şekilde yeniden denemeye çalıştığı için isteğinizi, bozuk istekler veya geniş ölçekli hatalar Goodle sunucularına taşmayacak şekilde yeniden denemeniz gerekir. Yani isteklerinizi yeniden denerken eksponansiyel geri yükleme kullanmanız gerekir. Üstel geri çekilme, sunucunun toparlanması için zaman tanımak amacıyla sizi isteklerinizi zamanında yaymaya zorlar.

Ö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. Böylece, art arda gelen her isteği yalnızca aralarındaki süreyi iki katına çıkararak etkin bir şekilde yayarsınız.

3D Karolar

Sunucu hatalarını ele almaktan sorumlu olan oluşturucu aracılığıyla fotogerçekçi kutulara eriştiğiniz için Google'ın sunucusundan gelen hatalar sizin için açık olmayabilir.

Parça oluşturucu hataları

Örneğin, sunucu hataları ortaya çıktığında CesiumJS oluşturucu genellikle sessizce başarısız olur. Bu da kilitlenmelerden, boş ekranlardan veya belirli parçaları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şturucular için çoğu tarayıcıda yerleşik olarak bulunan 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 bulunmaktadır.

400: Geçersiz bağımsız değişken
Geçersiz API anahtarları, sorgu parametreleri, parça/parça kimliği veya süresi dolmuş bir oturum jetonu.
403: İzin reddedildi
API anahtarı veya SSL bağlantısı yok ya da API anahtarınız, 3D Karolar için izin verilenler listesine eklenmemiş. Map Tiles API'nin 3D Karo işlevi için izin verilenler listesine eklenmek üzere proje kimliğinizle birlikte Google Destek ekibiyle 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.