Komunikaty o błędach w statycznym interfejsie API Map

Interfejs Statyczny interfejs API Map Google może generować błędy lub ostrzeżenia, gdy coś pójdzie nie tak. W tym przewodniku znajdziesz opisy poszczególnych komunikatów o błędach i dowiesz się, jak je naprawić.

Nieprawidłowe żądania

W przypadku nieprawidłowego żądania interfejs Statyczny interfejs API Map Google zwraca kod stanu HTTP 4xx i komunikat z opisem problemu. Oto przykłady takich problemó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 warunku 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 nie zawiera go w żądaniu. 400 BAD REQUEST
Klucz interfejsu API dołączony do żądania jest nieprawidłowy. 403 FORBIDDEN

Błędy, które uniemożliwiają wyświetlanie mapy

Jeśli żądanie jest prawidłowe, ale występuje inny błąd, który uniemożliwia wyświetlenie mapy, interfejs Google Static API wyświetla w zależności od błędu tekst lub obraz błędu zamiast mapy. Przykładem takiego błędu jest sytuacja, gdy aplikacja przekracza limity wykorzystania.

Obraz mapy wyświetlany zamiast mapy
Ilustracja: zamiast mapy wyświetla się błąd

Jeśli używasz interfejsu statycznego interfejsu API Map Google bez klucza interfejsu API lub nie masz włączonych płatności na koncie, zamiast mapy zobaczysz obraz błędu z linkiem wskazującym typ błędu. Na przykład: "g.co/staticmaperror/key".

Błędy bez użycia kluczy i rozwiązania
Błąd limitów wykorzystania: został przekroczony dzienny limit wczytywania map Używasz Maps Static API bez klucza interfejsu API. Aby rozwiązać ten problem: musisz:
  1. Pobierz klucz interfejsu API
  2. Włącz płatności
  3. Podpisywanie adresu URL
Błąd limitów wykorzystania: w adresach URL żądań brakuje podpisu cyfrowego W Twoim żądaniu brakuje podpisu cyfrowego (wymagane). Aby rozwiązać ten problem, podpisz swój adres URL.

Ostrzeżenia

W niektórych warunkach interfejs API zwraca mapę, ale może w nich brakować pewnych informacji. W takim przypadku pojawią się 2 warunki, które poinformują Cię o tym ostrzeżeniu.

  • Po pierwsze, mapa wyświetla się z żółtym paskiem błędu widocznym nad mapą z tekstem „Błąd mapy: g.co/staticmaperror"”.
  • Po drugie, interfejs API zwraca ostrzeżenie w formie nagłówka HTTP o nazwie X-Staticmap-API-Warning.

Na przykład ten URL zawiera nieoczekiwaną wartość parametru 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 widać żółty pasek błędu nałożony na obraz przy użyciu "błąd mapy: g.co/staticmaperror":

Pojawia się mapa, ale występuje błąd mapy: g.co/staticmaperror

Interfejs API zwraca też taki nagłówek HTTP:

X-Staticmap-API-Warning:Error geocoding: marker 1

W tej tabeli opisano ostrzeżenia, które interfejs API może przekazywać 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 przetwarzania danych geograficznych żądania wystąpił błąd. Występuje wiele wariantów tej wiadomości, w zależności od elementu, w przypadku którego nie udało się zastosować geokodowania (centrum, znacznik, widoczny lub ścieżka). Liczba elementów, które nie przeszły testu, jest nieskuteczna. Przykładem tego ostrzeżenia jest X-Staticmap-API-Warning:Error geocoding: marker 1, jak pokazano w powyższym przykładzie.
Too many geocoded markers requested (max is 15). Żądanie określa maksymalną dozwoloną liczbę znaczników z adresem zrozumiałym dla człowieka. Maksymalna liczba to 15. Ten limit dotyczy tylko znaczników określonych jako adres czytelny dla człowieka, który wymaga geokodowania. Nie dotyczy to znaczników określonych za pomocą współrzędnych geograficznych.
Too many geocoded polyline vertices requested (max is 15). Żądanie określa maksymalną dozwoloną liczbę linii łamanych w adresie czytelnym dla człowieka. Maksymalna liczba to 15. Ten limit dotyczy tylko linii łamanych z wierzchołkami określonymi jako zrozumiałe dla człowieka, które wymagają geokodowania. Nie dotyczy to linii łamanych podanych za pomocą współrzędnych geograficznych.

Ostrzeżenia nagłówka HTTP pojawiają się w konsoli Narzędzi deweloperskich w Chrome, w konsoli internetowej Firefox i w innych równoważnych narzędziach w przeglądarce.