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łędów, które spowodują wyświetlenie ciemnej mapy z tłomem.
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 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 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 rozwiązać ten problem, upewnij się, że żą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 interfejsu API
Błędy związane z rozliczeniami i stroną odsyłającą HTTP
Przyciemniona mapa lub „negatywowe” zdjęcie Street View z tytułem „for development purposes only” (tylko do celów rozwojowych) jest zwracane, 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 sprawdź, czy podana forma płatności jest prawidłowa.
- Przekroczono samookreślony limit dzienny. Dowiedz się, jak wyświetlać i zmieniać dzienne limity opłat
- Brakuje żądania strony odsyłającej HTTP, a 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 strony odsyłającej 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 deweloperów. Poniżej znajdziesz listę narzędzi do sprawdzania danych w konsoli w niektórych innych przeglądarkach.
- Konsola w Internet Explorerze.
- Konsola internetowa w Firefoksie.
- 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 włączyć lub wyłączyć konsolę JavaScript.