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

Jeśli żądanie się nie powiedzie, interfejs Street View Static API zwraca błąd lub ostrzeżenie. W tym przewodniku wyjaśniamy komunikaty o błędach i podajemy instrukcje 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 błędów, ale nie jest to wyczerpująca lista. Aby poznać szczegóły konkretnych problemów, możesz sprawdzić rzeczywisty kod błędu i komunikat zwracany 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 nie ma go w żądaniu. 400 BAD REQUEST
Klucz interfejsu API zawarty w żądaniu jest nieprawidłowy. 403 FORBIDDEN

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

Jeśli żądanie jest prawidłowe, ale wystąpi inny błąd, który uniemożliwia wyświetlenie zdjęcia Street View, interfejs Street View Static API zwraca tekst lub obraz błędu zamiast zdjęcia Street View, w zależności od błędu. Przykładem takiego błędu jest przekroczenie przez aplikację limitów wykorzystania.

Obraz błędu wyświetlany zamiast zdjęcia Street View
Rysunek: 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 są włączone płatności, na stronie zamiast zdjęcia Street View wyświetli się obraz błędu z linkiem wskazującym typ błędu. Na przykład „g.co/streetviewerror/key”.

Błędy i rozwiązania dotyczące logowania bez kluczy
Błąd limitów wykorzystania: przekroczono podany dzienny limit wczytywania mapy Używasz interfejsu Street View Static API bez klucza interfejsu API. Aby rozwiązać ten problem, wykonaj te czynności:
  1. Uzyskiwanie klucza 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 Twojej prośbie brakuje wymaganego podpisu cyfrowego. Aby rozwiązać ten problem, podpisz adres URL.