Maps Static API bir şeyler ters gittiğinde hata veya uyarı verebilir. Bu kılavuzda her hata mesajı açıklanmakta ve hataların çözümüyle ilgili ek talimatlar sağlanmaktadır.
Geçersiz istekler
Geçersiz bir istek olması 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 durumlarına ilişkin örnekler verilmiştir. Not: Bu liste, olası hataların tam listesi değildir. Belirli sorunların ayrıntıları için lütfen API tarafından döndürülen asıl 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 yok. |
400 BAD REQUEST |
| İstekte yer alan API anahtarı geçersiz. | 403 FORBIDDEN |
Bir haritanın görüntülenmesini engelleyen hatalar
İstek geçerliyse ancak haritanın görüntülenmesini engelleyen başka bir hata oluşursa Maps Static API, hataya bağlı olarak harita yerine metin veya hata resmi döndürür. Böyle bir hata koşuluna örnek olarak, uygulamanın kullanım sınırlarını aşması gösterilebilir.
API anahtarları ve faturalandırmayla ilgili hatalar
Maps Static API'yi API anahtarı olmadan kullanıyorsanız veya hesabınızda faturalandırma özelliği etkin değilse sayfada, harita yerine hata resmi ve hatanın türünü belirten bir bağlantı gösterilir. Örneğin, "g.co/staticmaperror/key".
| Anahtarsız hatalar ve çözümler | |
|---|---|
 |
Maps Static API'yi API anahtarı olmadan kullanıyorsunuz. Bu sorunu çözmek için yapmanız gerekenler: |
 |
İsteğinizde dijital imza eksik (gerekli). Sorunu çözmek için URL'nizi imzalayın |
Uyarılar var
Bazı hata durumlarında API bir harita döndürür, ancak bazı bilgiler haritada eksik olabilir. Bu durumda, size uyarı hakkında bilgi vermek için iki koşul gerçekleşir.
- Birincisinde, harita gösterilir ancak haritanın üzerine "Harita hatası: g.co/staticmaperror" yazısı ve sarı bir hata çubuğu yerleştirilmiştir.
- İkincisi, API
X-Staticmap-API-Warningadlı bir HTTP üst bilgisi biçiminde uyarı döndürür.
Örneğin, aşağıdaki URL markers parametresinde beklenmeyen bir değer içeriyor:
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 resmin üzerine "Harita hatası: g.co/staticmaperror" ifadesi bulunan sarı bir hata çubuğu gösterir:
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 verebileceği uyarılar açıklanmaktadır:
X-Staticmap-API-Warning üstbilgilerinde uyarılar var
|
|
|---|---|
Error geocoding:
[center, ][marker #number, ][visible #num, ][path #num, ]* |
İsteğin coğrafi kodlaması yapılırken bir hata oluştu. Coğrafi kodlamanın başarısız olduğu öğeye (merkez, işaretçi, görünür öğe veya yol) ve başarısız olan öğe sayısına bağlı olarak bu mesajın birçok varyantı vardır. Bu uyarıya örnek olarak yukarıdaki örnekte görüldüğü gibi X-Staticmap-API-Warning:Error geocoding: marker 1 verilebilir. |
Too many geocoded markers requested (max is 15). |
İstek, okunabilir bir adrese sahip olan izin verilen maksimum işaretçi sayısından daha fazla işaret belirtiyor. Maksimum sayı 15'tir. Bu sınırın yalnızca coğrafi kodlama gerektiren, kullanıcılar tarafından okunabilir bir adres olarak belirtilen işaretçiler için geçerli olduğunu unutmayın. Enlem/boylam koordinatları ile belirtilen işaretçiler için geçerli değildir. |
Too many geocoded polyline vertices requested (max is 15). |
İstek, okunabilir bir adresle izin verilen maksimum çoklu satır sayısını aşıyor. Maksimum sayı 15'tir. Bu sınırın yalnızca köşeleri coğrafi kodlama gerektiren, kullanıcıların okuyabileceği adresler olarak belirtilen çoklu çizgiler için geçerli olduğunu unutmayın. Enlem/boylam koordinatlarıyla belirtilen çoklu çizgiler için geçerli değildir. |
HTTP üst bilgisi uyarılarını Chrome Geliştirici Araçları Konsolu'nda, Firefox Web Konsolu'nda veya tarayıcınızdaki eşdeğer araçlarda görebilirsiniz.