Na tej stronie opisaliśmy komunikaty o błędach, które mogą być zwracane Maps Embed API. W razie wystąpienia błędu parametr Interfejs Maps Embed API wyświetla tekst komunikatu o błędzie zamiast mapy. Mogą również wystąpić pewne warunki błędu, które powodują wyświetlenie przyciemnioną mapę ze znakiem wodnym.
Nieprawidłowe żądania
W przypadku nieprawidłowego żądania interfejs Maps Embed API zwraca
kod stanu HTTP 4xx oraz komunikat opisujący
. Poniżej znajdziesz przykłady takich błędów. Uwaga: to nie jest
pełną listę możliwych błędów. Sprawdź rzeczywisty kod błędu
i komunikat zwracany przez interfejs API
zawierający szczegółowe informacje na temat konkretnych problemów.
| Przykład stanu błędu | Kod stanu |
|---|---|
Żądanie zawiera nieprawidłowy parametr lub wymagany parametr to
brak. Na przykład parametru zoom nie ma w parametrze
oczekiwany zakres wartości liczbowych lub brakuje wymaganego parametru w
do ich przesłania. |
400 BAD REQUEST |
| Klucz interfejsu API zawarty w żądaniu jest nieprawidłowy. | 403 FORBIDDEN |
Błędy klucza interfejsu API i limitów
Błędy klucza interfejsu API i limitów są traktowane jako nieprawidłowe żądania. Możliwe przyczyny należy uwzględnić następujące elementy:
- Brak klucza interfejsu API lub nieprawidłowy klucz. Aby naprawić ten błąd, upewnij się, że zawiera prawidłowy klucz interfejsu API. Uzyskaj klucz interfejsu API.
- Interfejs Maps Embed API nie jest włączony w Twoim projekcie. Więcej informacji o włączaniu i wyłączaniu interfejsów API.
- Klucz interfejsu API narusza ograniczenia. Przeczytane o sprawdzonych metodach dotyczących kluczy interfejsu API.
Płatności i błędy strony odsyłającej HTTP
Zaciemniona mapa lub „negatywna” Zdjęcie Street View ze znakiem wodnym „×” dla tylko do celów programistycznych”. jest zwracany, jeśli jest spełniony dowolny z tych warunków:
- Płatności nie zostały włączone na Twoim koncie. Włącz płatności.
- Podana forma płatności jest nieprawidłowa (np. wygasła kwota promocyjna) ). Aby rozwiązać ten problem, sprawdź w konsoli Google Cloud, czy masz podaną prawidłową formę płatności.
- Narzucony dzienny limit został przekroczony. Dowiedz się, jak wyświetlić lub zmienić dzienny limit rozliczeń.
- W żądaniu brakuje strony odsyłającej HTTP, a używasz tagu klucz interfejsu API z ograniczonym dostępem do stron odsyłających. Informacje Dowiedz się więcej o dodawaniu witryn odsyłających.
Sprawdź błędy w przeglądarce
W przypadku błędów dotyczących rozliczeń i stron odsyłających HTTP interfejs Maps Embed API
komunikaty o błędach do window.console. W przypadku nieprawidłowych żądań (w tym
klucza interfejsu API i błędów limitu), zgłaszany jest tylko kod stanu HTTP 4xx.
w konsoli. W tej sekcji wyjaśniono, jak sprawdzić dane wyjściowe konsoli w
Google Chrome Jeśli używasz innej przeglądarki, skontaktuj się z deweloperem
dokumentacji przeglądarki. Oto lista narzędzi do
sprawdź dane wyjściowe konsoli w innych przeglądarkach.
- Konsola Internet Explorera.
- Konsola sieciowa w przeglądarce Firefox.
- Zdalne debugowanie na Androida.
- Inspektora sieci na iOS.
W Chrome możesz użyć funkcji Konsola JavaScript aby sprawdzić dane wyjściowe konsoli w podany niżej sposób.
- Aby otworzyć Narzędzia dla programistów, kliknij ikonę menu > Więcej narzędzi > Narzędzia dla deweloperów.
- Aby otworzyć konsolę JavaScript, kliknij kartę Console (Konsola) u góry strony w oknie Narzędzia dla deweloperów. Możesz też użyć klawisza ESC, aby JavaScriptu.