Maps Static API bir hata veya uyarı mesajı verebilir yanlış. Bu kılavuzda her bir hata mesajı açıklanmakta ve daha ayrıntılı talimatları uygulayın.
Geçersiz istekler
Geçersiz bir istek durumunda, Maps Static API şunları döndürür:
bir HTTP 4xx durum kodu ve
sorun. Aşağıda bu tür hata koşullarına örnekler verilmiştir. Not: Bu listede olası her hata yer almamaktadır. Lütfen gerçek hata kodunu kontrol edin
ve belirli sorunların ayrıntıları için API tarafından döndürülen mesaj.
| Hata durumu örneği | Durum kodu |
|---|---|
İstek geçersiz bir parametre içeriyor veya gerekli bir parametre eksik. Örneğin, size parametresi
beklenen sayısal değer aralığı veya istekte eksik. |
400 BAD REQUEST |
| İsteğe dahil edilen API anahtarı geçersiz. | 403 FORBIDDEN |
Haritaların gösterilmesini engelleyen hatalar
İstek geçerliyse ancak haritanın gösterilmesini engelleyen başka bir hata meydana gelirse Maps Static API, hataya bağlı olarak harita yerine metin veya hata resmi döndürür. Böyle bir hataya örnek durumu, uygulamanın kullanım sınırlarını aşmamalıdır.
API anahtarları ve faturalandırmayla ilgili hatalar
Maps Static API'yi API anahtarı olmadan kullanıyorsanız veya faturalandırma özelliği hesabınızda etkinleştirilmediyse, sayfada hatanın türünü gösteren bir bağlantıyla birlikte gösterilir. Örneğin: "g.co/staticmaperror/key".
| Anahtarsız hatalar ve çözümleri | |
|---|---|
 |
Maps Static API'yi API anahtarı olmadan kullanıyorsunuz. Bu sorunu çözmek için: |
 |
İsteğinizde dijital imza eksik (zorunlu). Çözüm için: URL'nizi imzalayın |
Uyarılar var
API, bazı hata koşullarında bir harita döndürür ancak haritadan bazı bilgiler eksik olabilir. Böyle bir durumda sizi bilgilendirmek için iki koşul uyarı görürsünüz.
- Birincisi, harita gösterilir ancak haritanın üst kısmında "Harita hatası: g.co/staticmaperror" metnini içeren sarı bir hata çubuğu bulunur.
- İkincisi, API, Search Console'da
X-Staticmap-API-Warningadlı bir HTTP üstbilgisi biçimindedir.
Örneğin, aşağıdaki URL
markers parametresi:
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ür ancak "Harita hatası: g.co/staticmaperror" ifadesini içeren sarı bir hata çubuğunu resmin üzerine yerleştirir:
API aşağıdaki HTTP başlığını da döndürür:
X-Staticmap-API-Warning:Error geocoding: marker 1
Aşağıdaki tabloda, API'nin HTTP üst bilgileri olarak gönderebileceği uyarılar açıklanmaktadır:
X-Staticmap-API-Warning üstbilgide uyarı var
|
|
|---|---|
Error geocoding:
[center, ][marker #number, ][visible #num, ][path #num, ]* |
İsteğin coğrafi kodlamasını yapmaya çalışırken bir hata oluştu. Coğrafi kodlamanın başarısız olduğu öğeye (orta, işaretçi, görünür veya yol) ve başarısız olan öğelerin sayısına bağlı olarak bu mesajın birçok varyantı vardır. Bu uyarının bir örneği:
X-Staticmap-API-Warning:Error geocoding: marker 1, olduğu gibi
aşağıdaki örnekte gösterildiği gibidir. |
Too many geocoded markers requested (max is 15). |
İstek, kullanıcı tarafından okunabilen bir adresle izin verilen maksimum işaretçi sayısından daha fazla işaretçi belirtiyor. Maksimum sayı 15'tir. Bu sınırın yalnızca, coğrafi kodlama gerektiren, kullanıcı tarafından okunabilen bir adres olarak belirtilen işaretçiler için geçerli olduğunu unutmayın. Enlem/boylam koordinatlarıyla belirtilen işaretçiler için geçerli değildir. |
Too many geocoded polyline vertices requested (max is 15). |
İstek, kullanıcı tarafından okunabilen bir adresle izin verilen maksimum poli çizgi sayısından daha fazlasını belirtiyor. Maksimum 15 kişidir. Bu sınır yalnızca köşeleri insan tarafından okunabilir adresler olarak belirtilmiş çoklu çizgiler için geçerlidir coğrafi kodlama gerektirir. Şunlarla belirtilen çoklu çizgiler için geçerli değildir: enlem/boylam koordinatları. |
HTTP üstbilgi uyarılarını Chrome Geliştirici Araçları Konsolu'nda, Firefox Web Konsolu'nda veya tarayıcınızdaki eşdeğer diğer araçlarda görebilirsiniz.