Komunikaty o błędach w interfejsie Street View Static API

Gdy żądanie nie powiedzie się, interfejs Street View Static API zwraca 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 Street View Static API zwraca kod stanu HTTP 4xx i komunikat opisujący problem. W tabeli poniżej znajdziesz przykłady takich warunków błędu. Nie jest to jednak pełna lista możliwych błędów. Aby uzyskać szczegółowe informacje o konkretnych problemach, możesz sprawdzić rzeczywisty kod błędu i komunikat zwrócony przez interfejs API.

Przykład stanu 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 interfejsu API zawarty w żądaniu jest nieprawidłowy. 403 FORBIDDEN

Błędy uniemożliwiające wyświetlenie obrazu Street View

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

Zamiast zdjęcia Street View wyświetla się obraz błędu
Ilustracja: obraz błędu wyświetlany zamiast zdjęcia Street View

Jeśli używasz interfejsu Street View Static API bez klucza interfejsu API lub jeśli na Twoim koncie nie jest włączone rozliczanie, na stronie wyświetli się obraz błędu zamiast obrazu Street View. Będzie też widoczny link wskazujący typ błędu. Na przykład „g.co/streetviewerror/key”.

Błędy związane z brakiem klucza i sposoby ich naprawiania
Błąd limitów wykorzystania: przekroczono podany dzienny limit wczytań mapy Używasz interfejsu Street View Static API bez klucza interfejsu API. Aby rozwiązać ten błąd, wykonaj te czynności:
  1. Pobieranie klucza interfejsu API
  2. Włącz płatności
  3. Podpisz adres URL
Błąd limitów wykorzystania: w adresach URL żądań brakuje podpisu cyfrowego W prośbie brakuje wymaganego podpisu cyfrowego. Aby rozwiązać ten problem, podpisz adres URL.