Bu sayfa, Cloud Translation API ile çevrilmiştir.

Hataları işleme

Avrupa Ekonomik Alanı (AEA) geliştiricileri

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

Listeleme hatası

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ı 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 döşemeleri 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 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 düzey yakınlaştırmaya kadar normal harita parçalarıyla aynıdır. Bu noktada, maksimum değerler imageHeight veya imagewidth'nin tileHeight veya tileWidth'e bölünmesiyle elde edilir.

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) adresine sahip bir faturalandırma hesabına bağlı projelerde kullanılamaz. Daha fazla bilgi için AEA'daki müşteriler için Harita Döşemeleri API'sinde yapılan düzenlemeler başlıklı makaleyi inceleyin.

expired

session jetonunuzun süresi doldu. Oturum jetonu, oluşturulma zamanından 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 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 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, bozuk isteklerin veya geniş çaplı hataların Google sunucularını doldurmaması için isteğinizi yeniden göndermelisiniz. Bunun nedeni, birçok istemcinin istekleri hızlı bir şekilde yeniden göndermeye çalışmasıdır. Bu, isteklerinizi yeniden denerken eksponansiyel geri yükleme kullanmanız gerektiği anlamına gelir. Üstel geri çekilme, 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 deneme 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, aralarındaki süreyi iki katına çıkararak her bir sonraki isteği etkili bir şekilde yayabilirsiniz.

3B parçalar

Google'ın sunucusundan kaynaklanan hatalar, sunucu hatalarını işlemekten sorumlu olan 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 kutucukların yüklenmemesine kadar çeşitli sorunlara yol açabilir.

Sunucu hatalarını ayıklamak için kullandığı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.

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, 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 döşemesi istemek için kullanılamaz.

403: İzin reddedildi