Maps Static API, bir istek başarısız olduğunda hata veya uyarı verir. Bu kılavuzda hata mesajları açıklanmakta ve bunların nasıl çözüleceğiyle ilgili talimatlar verilmektedir.
Geçersiz istekler
Geçersiz bir istek için Maps Static API, aşağıdaki listede gösterildiği gibi bir HTTP 4xx durum kodu ve sorunu açıklayan bir mesaj döndürür. Belirli sorunların ayrıntıları için API tarafından döndürülen gerçek hata kodunu ve mesajını kontrol edin.
- İstek geçersiz bir parametre içeriyor veya gerekli bir parametre eksik. Örneğin,
sizeparametresi beklenen sayısal değer aralığında değil veya istekte eksik. 400 BAD REQUEST- İstekle birlikte gönderilen API anahtarı geçersiz.
403 FORBIDDEN
Haritanın görüntülenmesini engelleyen hatalar
İstek geçerliyse ancak haritanın gösterilmesini engelleyen başka bir hata oluşursa Maps Static API, harita yerine metin veya hata resmi döndürür. Örneğin, uygulama kullanım sınırlarını aştığında hata oluşur.
API anahtarları ve faturalandırmayla ilgili hatalar
Maps Static API'yi API anahtarı olmadan kullanıyorsanız veya hesabınızda faturalandırma etkin değilse sayfada harita yerine hata türünü belirten bir bağlantıyla birlikte hata resmi gösterilir. Örneğin, "g.co/staticmaperror/key."
| Anahtarsız hatalar ve çözümleri | |
|---|---|
 |
Haritalar Statik API'sini API anahtarı olmadan kullanıyorsunuz. Bu hatayı düzeltmek için aşağıdaki adımları tamamlayın: |
 |
İsteğinizde gerekli dijital imza eksik. Bu hatayı düzeltmek için URL'nizi imzalayın. |
Uyarılar var
API, bazı hata koşullarında bir harita döndürür ancak haritada bazı bilgiler eksik olabilir. Bu durumda, aşağıdaki koşulları kullanarak uyarıyı belirleyebilirsiniz:
- Harita, üzerine yerleştirilmiş sarı bir hata çubuğuyla birlikte gösterilir. Hata çubuğunda "Harita hatası: g.co/staticmaperror" metni yer alır.
- API,
X-Staticmap-API-Warningadlı bir HTTP başlığı biçiminde uyarı döndürür.
Örneğin, aşağıdaki URL'de markers parametresinde beklenmeyen bir değer var:
https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY
API bir harita döndürüyor ancak resmin üzerine yerleştirilmiş sarı bir hata çubuğu gösteriliyor ve bu çubukta "Harita hatası: g.co/staticmaperror" metni yer alıyor:
API ayrıca aşağıdaki HTTP üst bilgisini de döndürür:
X-Staticmap-API-Warning:Error geocoding: marker 1
Aşağıdaki tabloda, API'nin HTTP üstbilgileri olarak verebileceği uyarılar açıklanmaktadır:
X-Staticmap-API-Warning üstbilgilerindeki uyarılar
|
|
|---|---|
Error geocoding:
[center, ][marker #number, ][visible #num, ][path #num, ]* |
İstek coğrafi olarak kodlanmaya çalışılırken bir hata oluştu. Bu mesajın, coğrafi kodlamanın başarısız olduğu öğeye (ör. center, marker, visible veya path) ve başarısız olan öğe sayısına bağlı olarak birçok varyasyonu vardır. Bu uyarıya bir örnek olarak, önceki örnekte gösterildiği gibi X-Staticmap-API-Warning:Error geocoding: marker 1 verilebilir. |
Too many geocoded markers requested (max is 15). |
İstek, okunabilir adrese sahip izin verilen maksimum işaretçi sayısından daha fazlasını belirtiyor. En fazla 15 olabilir. Bu sınır yalnızca coğrafi kodlama gerektiren, insan tarafından okunabilir bir adres olarak belirtilen işaretçiler için geçerlidir. Bu durum, enlem ve boylam koordinatlarıyla belirtilen işaretçiler için geçerli değildir. |
Too many geocoded polyline vertices requested (max is 15). |
İstek, okunabilir adrese sahip izin verilen maksimum çoklu çizgi sayısından daha fazlasını belirtiyor. En fazla 15 olabilir. Bu sınır yalnızca coğrafi kodlama gerektiren, insan tarafından okunabilir adresler olarak belirtilen köşeleri olan çoklu çizgi için geçerlidir. Enlem ve boylam koordinatlarıyla belirtilen çoklu çizgiler için geçerli değildir. |
HTTP başlığı uyarılarını Chrome Geliştirici Araçları Konsolu, Firefox Web Konsolu veya tarayıcınızdaki diğer eşdeğer araçlarda görebilirsiniz.