Na tej stronie opisujemy komunikaty o błędach, które może zwrócić interfejs Maps Embed API. Gdy wystąpi błąd, interfejs Maps Embed API wyświetli komunikat o błędzie zamiast mapy. Mogą też wystąpić określone warunki błędu, które spowodują wyświetlenie ciemnej mapy z tłomaczeniami.
Nieprawidłowe żądania
W przypadku nieprawidłowego żądania interfejs Maps Embed API zwraca kod stanu HTTP 4xx oraz 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 zoom nie mieści się w oczekiwanym zakresie wartości liczbowych lub w żądaniu brakuje wymaganego parametru. |
400 BAD REQUEST |
| Klucz API podany w żądaniu jest nieprawidłowy. | 403 FORBIDDEN |
Błędy związane z kluczem interfejsu API i limitami
Błędy związane z kluczem API i limitem są traktowane jako nieprawidłowe żądania. Możliwe przyczyny:
- Brakujący lub nieprawidłowy klucz interfejsu API. Aby naprawić ten błąd, sprawdź, czy żądanie zawiera prawidłowy klucz interfejsu API. Pobierz klucz interfejsu API.
- Interfejs Maps Embed API nie jest włączony w Twoim projekcie. Dowiedz się więcej o włączaniu i wyłączaniu interfejsów API.
- Klucz interfejsu API narusza ograniczenia. Więcej informacji o sprawdzonych metodach dotyczących kluczy API
Błędy związane z rozliczeniami i refererem HTTP
Przyciemniona mapa lub „negatyw” obrazu Street View z tytułem „tylko do celów rozwojowych” jest zwracany, gdy jest spełniony co najmniej 1 z tych warunków:
- Na Twoim koncie nie włączono płatności. Włącz płatności.
- podana metoda płatności jest nieprawidłowa (np. karta kredytowa z wygasłym terminem ważności). Aby rozwiązać ten problem, otwórz konsolę Google Cloud i upewnij się, że podana przez Ciebie forma płatności jest prawidłowa.
- Przekroczono samookreślony limit dzienny. Dowiedz się, jak wyświetlać i zmieniać dzienne limity opłat
- W żądaniu brakuje strony odsyłającej HTTP, a Ty używasz klucza interfejsu API z ograniczeniem strony odsyłającej. Więcej informacji o dodawaniu stron odsyłających
Sprawdzanie błędów w przeglądarce
W przypadku błędów związanych z płatnościami i adresem referencyjnym HTTP interfejs Maps Embed API zapisuje komunikaty o błędach w pliku window.console. W przypadku nieprawidłowych żądań (w tym błędów związanych z kluczem API i limitem) w konsoli jest zgłaszany tylko kod stanu HTTP 4xx. Z tej sekcji dowiesz się, jak sprawdzić dane konsoli w Google Chrome. Jeśli używasz innej przeglądarki, zapoznaj się z dokumentacją dla programistów dotyczącą tej przeglądarki. Poniżej znajdziesz listę narzędzi do sprawdzania danych w konsoli w niektórych innych przeglądarkach.
- Konsola w Internet Explorerze.
- Konsola internetowa w Firefoxie.
- Debugowanie zdalne na Androidzie.
- Web Inspector na iOS.
W Chrome możesz użyć konsoli JavaScriptu, aby sprawdzić dane konsoli w ten sposób:
- Aby otworzyć Narzędzia dla deweloperów, kliknij ikonę menu > Więcej narzędzi > Narzędzia dla deweloperów.
- Aby otworzyć konsolę JavaScriptu, kliknij kartę Konsola u góry okna Narzędzia dla programistów. Możesz też użyć klawisza ESC, aby przełączyć konsolę JavaScript.