Jeśli żądanie się nie powiedzie, interfejs Maps Static API wygeneruje błąd lub ostrzeżenie. W tym przewodniku znajdziesz wyjaśnienia komunikatów o błędach i instrukcje dotyczące 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, jak pokazano na poniższej liście. Szczegółowe informacje o konkretnych problemach znajdziesz w rzeczywistym kodzie błędu i komunikacie zwracanym przez interfejs API.
- Żądanie zawiera nieprawidłowy parametr lub brakuje wymaganego parametru. Na przykład parametr
sizenie mieści się w oczekiwanym zakresie wartości liczbowych lub brakuje go w żądaniu. 400 BAD REQUEST- Klucz interfejsu API zawarty 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, który uniemożliwia wyświetlenie mapy, interfejs Maps Static API zwraca zamiast niej tekst lub obraz błędu. Na przykład błąd występuje, gdy aplikacja przekracza limity wykorzystania.
Błędy związane z kluczami interfejsu API i płatnościami
Jeśli używasz interfejsu Maps Static API bez klucza API lub jeśli na Twoim koncie nie jest włączone rozliczanie, na stronie 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 brakiem klucza i sposoby ich naprawiania | |
|---|---|
 |
Korzystasz z interfejsu Maps Static API bez klucza interfejsu API. Aby rozwiązać ten błąd, wykonaj te czynności: |
 |
W prośbie brakuje wymaganego podpisu cyfrowego. Aby rozwiązać ten problem, podpisz adres URL. |
Ostrzeżenia
W przypadku niektórych błędów interfejs API zwraca mapę, ale może ona nie zawierać pewnych informacji. W takim przypadku możesz rozpoznać ostrzeżenie, korzystając z tych warunków:
- Mapa wyświetla się z żółtym paskiem błędu z tekstem „Błąd mapy: g.co/staticmaperror”.
- 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 wyświetla żółty pasek błędu nałożony na obraz z tekstem „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 znajdziesz opisy ostrzeżeń, 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 wariantów tego komunikatu w zależności od elementu, w którym geokodowanie się nie powiodło, np. center, marker, visible lub path, oraz liczby elementów, w których wystąpił błąd. Przykładem takiego ostrzeżenia jest X-Staticmap-API-Warning:Error geocoding: marker 1, jak pokazano w poprzednim przykładzie. |
Too many geocoded markers requested (max is 15). |
Żądanie określa więcej niż maksymalną dozwoloną liczbę znaczników z adresem czytelnym dla człowieka. Maksymalna liczba to 15. Ten limit dotyczy tylko znaczników określonych jako adres zrozumiały dla człowieka, który wymaga geokodowania. Nie dotyczy to markerów określonych za pomocą współrzędnych geograficznych. |
Too many geocoded polyline vertices requested (max is 15). |
Żądanie zawiera więcej niż maksymalna dozwolona liczba linii łamanych z adresem czytelnym dla człowieka. Maksymalna liczba to 15. Ten limit dotyczy tylko linii łamanych, których wierzchołki są określone jako adresy czytelne dla człowieka, które wymagają geokodowania. Nie dotyczy to linii łamanych 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 w Firefoxie lub w innych podobnych narzędziach w przeglądarce.