Maps Static API, bir sorun olduğunda hata veya uyarı verebilir. Bu kılavuzda her hata mesajı açıklanmakta ve hataları çözmeyle ilgili daha fazla talimat verilmektedir.
Geçersiz istekler
Geçersiz bir istek durumunda Maps Static API, bir HTTP 4xx durum kodu ve sorunu açıklayan bir mesaj döndürür. Aşağıda bu tür hata koşullarına örnekler verilmiştir. Not: Bu listede olası her hata yer almamaktadır. Belirli sorunların ayrıntıları için lütfen API tarafından döndürülen gerçek hata kodunu ve mesajı kontrol edin.
| 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ığında değil veya istekte eksik. |
400 BAD REQUEST |
| İstekte yer alan 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. Bu tür bir hata durumuna örnek olarak, uygulamanın kullanım sınırlarını aşması verilebilir.
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 hatanın türünü belirten bir bağlantı içeren bir hata resmi 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 haritada bazı bilgiler eksik olabilir. Bu durumda, uyarıyı size bildirmek için iki koşul gerçekleşir.
- 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
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ür ancak "Harita hatası: g.co/staticmaperror" ifadesini içeren sarı bir hata çubuğunu resmin üzerine yerleştirir:
API, 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 üst bilgileri olarak gönderebileceği uyarılar açıklanmaktadır:
X-Staticmap-API-Warning üstbilgilerinde uyarılar
|
|
|---|---|
Error geocoding:
[center, ][marker #number, ][visible #num, ][path #num, ]* |
İsteğin coğrafi kodlaması yapılırken 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. Yukarıdaki örnekte gösterildiği gibi, bu uyarıya örnek olarak X-Staticmap-API-Warning:Error geocoding: marker 1 verilebilir. |
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 15 kişidir. Bu sınırın yalnızca kullanıcıların okuyabileceği bir adres olarak belirtilen ve coğrafi kodlama gerektiren 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 okunabilir bir adresle izin verilen maksimum poli çizgi sayısından daha fazlasını belirtiyor. Maksimum 15 kişidir. Bu sınırın yalnızca, köşe noktaları insan tarafından okunabilen adresler olarak belirtilen ve coğrafi kodlama gerektiren çoklu çizgiler için geçerli olduğunu unutmayın. Enlem/boylam koordinatlarıyla belirtilen poli çizgiler için geçerli değildir. |
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.