Hataları işleme

İstekte bulunduktan sonra hata içeren bir yanıt alabilirsiniz bolca fırsat sunuyor.

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

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

Hata listeleme

Aşağıdaki listede Harita parçaları API'si.

required

İsteğinizde bir URL parametresi eksik. Hata mesajı, parametresi eksik.

notFound, invalid

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

• Normal harita döşemelerinde, maksimum yakınlaştırma düzeyi bulunduğunuz bölgeye göre istediğiniz harita seçeneklerinde görünür.

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

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

• Street View parçaları için yakınlaştırma, sıfır ile beş arasında (0 ve beş dahil) olmalıdır.

• Street View parçaları için x ve y koordinat aralıkları aşağıdakilerle aynıdır: yakınlaştırma seviyesinde beşinci düzeye kadar. Bu durumda maksimum değerler, imageHeight veya imagewidth bölü tileHeight veya tileWidth.

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

expired

session jetonunuzun süresi doldu. Oturum jetonu şu süre için geçerlidir: iki hafta önce oluşturuldu. Bunun değişebileceğini unutmayın bildirimde bulunmadan. Bu hatayı alırsanız yeni bir oturum açmanız gerekir aşağıdaki adımları izleyin: Oturum jetonlarını kullanın.

badRequest

İsteğiniz hatalı biçimlendirilmiş. Bunun sık karşılaşılan nedeni şunlardı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 verilerinde enl/boy değerinin yanı sıra panorama kimliği gönderdiniz. isteğinde bulunabilirsiniz.

quotaExceeded, rateLimitExceeded

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

Ö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 şunu yapmalısınız: başarısız istekler veya geniş çaplı hatalar gibi yöntemlerle isteğinizi yeniden denemek çok sayıda istemci istekleri kısa sürede yeniden denemeye çalıştığından art arda gelir. Bunun için de eksponansiyel geri yükleme izin vermiş olursunuz. Üstel geri çekilme, sizi isteği zamanında iptal eder.

Örneğin, bir istek başarısız olursa bir saniye sonra yeniden deneyin. Ancak bu durumda girişimi de başarısız olur ve iki saniye sonra isteğinizi tekrar deneyin. Eğer isteği de başarısız oldu ve dört saniye sonra yeniden deneyin. Böylece her şeyi taleplerin arasındaki süreyi iki katına çıkararak bir istek gönderebilirsiniz.

3D Karo

Google'ın sunucusundaki hatalar size açık olmayabilir çünkü fotogerçekçi karoların işlenmesinden sorumlu olan bir oluşturucu ile sunucu hataları var.

Parça oluşturucu hataları

Örneğin, CesiumJS oluşturucu genellikle sunucu hataları oluştuğunda sessizce kilitlenmelere, boş ekranlara, hatta belirli bir süre için karolar yüklenmiyor.

Sunucu hatalarını ayıklamak için kullandığınız teknik, ilgili yazılımın oluşturmanız gerekir. CesiumJS gibi tarayıcı tabanlı oluşturucular için çoğu tarayıcıda yerleşik araçlarla ağ trafiğini azaltır. Örneğin, şunları yapabilirsiniz: kullan Chrome Geliştirici Araçları.

Yaygın görülen hatalar

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

400: Geçersiz bağımsız değişken

Geçersiz API anahtarları, sorgu parametreleri, öğe/öğe kümesi kimlikleri veya süresi dolmuş bir oturum .

403: İzin reddedildi

API anahtarı eksik, SSL bağlantısı yok veya API anahtarınız şu adrese eklenmemiş: izin verilenler listesine ekleyebilirsiniz. Google ile bağlantı kurun Eklenmek için proje kimliğinizle ilgili destek Map Tiles API'sinin 3D Parçalar işlevi için izin verilenler listesine ekleyin.

429: Çok fazla istek

Kotanız doldu. İletişim Google Destek ile iletişime geçebilirsiniz.