Gdy coś pójdzie nie tak, interfejs Map Static API może wyświetlić błąd lub ostrzeżenie. Ten przewodnik zawiera opisy poszczególnych komunikatów o błędach oraz instrukcje ich rozwiązywania.
Nieprawidłowe żądania
W przypadku nieprawidłowego żądania interfejs Maps Static API zwraca kod stanu HTTP 4xx i komunikat opisujący problem. Poniżej znajdziesz przykłady takich błędów. Uwaga: to nie jest pełna lista możliwych błędów. Aby uzyskać szczegółowe informacje o konkretnych problemach, sprawdź rzeczywisty kod błędu i komunikat zwrócony przez interfejs API.
| Przykład błędu | Kod stanu |
|---|---|
Żądanie zawiera nieprawidłowy parametr lub brakuje wymaganego parametru. Na przykład parametr size nie mieści się w oczekiwanym zakresie wartości liczbowych lub brakuje go w żądaniu. |
400 BAD REQUEST |
| Klucz API podany w żądaniu jest nieprawidłowy. | 403 FORBIDDEN |
Błędy uniemożliwiające wyświetlenie mapy
Jeśli żądanie jest prawidłowe, ale wystąpił inny błąd uniemożliwiający wyświetlenie mapy, interfejs Maps Static API zwróci zamiast mapy tekst lub obraz z błędem, w zależności od błędu. Przykładem takiej sytuacji jest przekroczenie limitu wykorzystania przez aplikację.
Błędy związane z kluczami API i płatnościami
Jeśli używasz interfejsu Maps Static API bez klucza API lub na Twoim koncie nie jest włączone rozliczenie, zamiast mapy wyświetli się obraz błędu z linkiem wskazującym typ błędu. Na przykład „g.co/staticmaperror/key”.
| Błędy związane z systemem bezkluczykowym i ich rozwiązania | |
|---|---|
 |
Używasz interfejsu Maps Static API bez klucza interfejsu API. Aby rozwiązać ten problem: |
 |
W Twoim żądaniu brakuje podpisu cyfrowego (wymagany). Aby rozwiązać problem: Podpisz adres URL |
Ostrzeżenia
W niektórych przypadkach błędu interfejs API zwraca mapę, ale może brakować na niej niektórych informacji. W takim przypadku otrzymasz ostrzeżenie, jeśli spełnione są 2 warunki.
- Po pierwsze, wyświetla się mapa, ale z żółtym paskiem błędu nałożonym na jej górną część.
- Po drugie, interfejs API zwraca ostrzeżenie w postaci nagłówka HTTP o nazwie
X-Staticmap-API-Warning.
Na przykład ten adres URL zawiera nieoczekiwaną wartość w parametrze markers:
https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY
Interfejs API zwraca mapę, ale na obrazie wyświetla żółty pasek błędu z informacją „Błąd mapy: g.co/staticmaperror”:
Interfejs API zwraca też ten nagłówek HTTP:
X-Staticmap-API-Warning:Error geocoding: marker 1
W tabeli poniżej opisano ostrzeżenia, które interfejs API może wysyłać jako nagłówki HTTP:
Ostrzeżenia w nagłówkach X-Staticmap-API-Warning
|
|
|---|---|
Error geocoding:
[center, ][marker #number, ][visible #num, ][path #num, ]* |
Podczas próby geokodowania żądania wystąpił błąd. Istnieje wiele wersji tego komunikatu, w zależności od elementu, w którym nie udało się przeprowadzić geokodowania (centrum, znacznik, widoczność lub ścieżka) oraz liczby elementów, w których przypadku nie udało się przeprowadzić geokodowania. Przykładem takiego ostrzeżenia jest X-Staticmap-API-Warning:Error geocoding: marker 1, jak pokazano w przykładzie powyżej. |
Too many geocoded markers requested (max is 15). |
żądanie określa większą niż dozwolona maksymalną liczbę znaczników z czytelnym adresem; Maksymalna liczba to 15. Pamiętaj, że ten limit dotyczy tylko znaczników określonych jako adresy zrozumiałe dla człowieka, które wymagają geokodowania. Nie dotyczy znaczników określonych za pomocą współrzędnych geograficznych. |
Too many geocoded polyline vertices requested (max is 15). |
Żądanie określa większą niż dozwolona maksymalną liczbę wielokątów z czytelnym adresem. Maksymalna liczba to 15. Pamiętaj, że ten limit dotyczy tylko polilinii z wierzchołkami określonymi jako adresy zrozumiałe dla człowieka, które wymagają geokodowania. Nie dotyczy ścieżek wielokątów określonych za pomocą współrzędnych geograficznych. |
Ostrzeżenia dotyczące nagłówka HTTP możesz zobaczyć w konsoli narzędzi deweloperskich w Chrome, konsoli internetowej Firefoxa lub w innych odpowiednich narzędziach w przeglądarce.