Na tej stronie opisujemy komunikaty o błędach, które mogą być zwracane przez Maps JavaScript API. Interfejs Maps JavaScript API zapisuje komunikatów o błędach i ostrzeżeniach. Mogą też wystąpić określone warunki błędu, które spowodują wyświetlenie przyciemnionej mapy z wodą.
Błędy związane z kluczem interfejsu API i płatnościami
Rozwiązywanie problemów
W pewnych okolicznościach może zostać wyświetlona przyciemniona mapa lub „negatywowy” obraz Street View z znakami wodnymi z tekstem „Tylko do celów rozwojowych”. Takie zachowanie zwykle wskazuje na problemy z kluczem API lub rozliczeniami. Aby korzystać z usług Google Maps Platform, musisz mieć na koncie włączone płatności, a wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Informacje o tym, jak znaleźć komunikaty o błędach, znajdziesz w sekcji Sprawdzanie błędów w przeglądarce.
Poniższy proces pomoże Ci rozwiązać ten problem.
Kody błędów interfejsu Maps JavaScript API dla programistów i właścicieli witryn
W tabeli poniżej znajdziesz listę możliwych kodów błędów zwracanych przez interfejs Maps JavaScript API wraz z opisem przyczyny i sposobu rozwiązania problemu. Pomoc w znalezieniu komunikatów o błędach znajdziesz w sekcji sprawdzanie błędów w przeglądarce.
Błędy wczytywania mapy
Jeśli podczas wczytywania interfejsu Maps JavaScript API wystąpi błąd, zapoznaj się z tabelą poniżej, aby znaleźć wyjaśnienia kodów błędów.
Kod błędu | Wiadomość | Opis |
---|---|---|
NotLoadingAPIFromGoogleMapsError
|
Interfejs Maps JavaScript API musi zostać pobrany bezpośrednio ze serwerów Google. |
Elementem skryptu, który wczytuje interfejs Maps JavaScript API, jest nie są poprawnie uwzględnione na stronie. Aby interfejs API działał prawidłowo, musi być ładowany bezpośrednio z adresu https://maps.googleapis.com. |
TOSViolationMapError
|
Wygląda na to, że ta witryna narusza Warunki korzystania z interfejsu API Map Google. Interfejs API Map Google został wyłączony w tej witrynie. |
Twoja aplikacja została zablokowana z powodu niezgodności z Warunkami korzystania z usługi Google Maps Platform, o czym powiadomiliśmy Cię kilkukrotnie e-mailem. Aby odwołać się od decyzji zablokuj i poproś o sprawdzenie implementacji, dokończ ten formularz. Odpowiedź otrzymasz e-mailem w ciągu kilku dni roboczych. Jeśli masz licencję na Google Maps Platform Premium, użyj Dane logowania w wersji premium Google Maps Platform do naprawienia tego błędu. Zapoznaj się z przewodnikiem dotyczącym uwierzytelniania w ramach abonamentu premium. |
UnauthorizedURLForClientIdMapError
|
Ten adres URL nie jest autoryzowany do używania podanego identyfikatora klienta Map Google. |
Plan Premium lub interfejsy Mapy dla firm: identyfikator klienta uwzględniony w załadowanym skrypcie jest nieprawidłowy, wygasł lub bieżący adres wczytujący interfejs Maps JavaScript API nie został dodany do listy autoryzowanych adresów URL. |
Kody błędów Maps JavaScript API
Jeśli znajdziesz błąd w konsoli JavaScriptu Chrome, konsoli internetowej Firefoxa lub innym odpowiednim narzędziu w przeglądarce, zapoznaj się z tabelą poniżej, aby znaleźć wyjaśnienia kodów błędów.
Interfejs Maps JavaScript API zwraca zarówno błędy, jak i ostrzeżenia. Błąd wskazuje poważny problem, który wystąpił podczas wczytywania interfejsu Maps JavaScript API. Strona nie może prawidłowo wczytać interfejsu API i nie będzie on na niej działać. Ostrzeżenie to dodatkowy komunikat o wczytaniu Maps JavaScript API. W ostrzeżeniem podano możliwe przyczyny pod kątem błędu lub sugerują potencjalne problemy w kodzie, który wczytuje Maps JavaScript API. Jeśli otrzymasz tylko ostrzeżenia bez błędów, interfejs API będzie działać. na tej stronie. Zalecamy jednak, abyś rozwiązał/a także te potencjalne problemy.
Kod błędu dewelopera | Typ | Opis |
---|---|---|
ApiNotActivatedMapError
|
Błąd |
Interfejs Maps JavaScript API nie został włączony w Twoim projekcie API. Może być konieczne włączenie Maps JavaScript API w sekcji Interfejsy API w w konsoli Google Cloud. Aby aktywować Maps JavaScript API w swoim projekcie, kliknij przycisk poniżej.
|
ApiTargetBlockedMapError
|
Błąd |
Ten klucz interfejsu API nie ma uprawnień do korzystania z tej usługi lub interfejsu API. Sprawdź ustawienia ograniczeń interfejsów API swojego klucza interfejsu API w Google Cloud Console, dzięki któremu możesz mieć pewność, że wszystkie interfejsy API i usługi, których potrzebujesz, których chcesz używać, są prawidłowo określone na liście włączonych interfejsów API. Zobacz kluczy interfejsów API w Cloud Console. Więcej informacji znajdziesz w artykule Sprawdzone metody dotyczące zabezpieczeń interfejsu API. |
DeletedApiProjectMapError
|
Błąd |
Twój projekt interfejsu API mógł zostać usunięty z konsoli Cloud. Sprawdź projekt, dla którego został wygenerowany klucz interfejsu API, który jest zawarty w ładowarce interfejsu API JavaScript. Możesz utworzyć nowy projekt API pobierz nowy klucz w konsoli Cloud. Aby utworzyć nowy projekt i uzyskać dla niego klucz interfejsu API, kliknij przycisk poniżej.
|
ClientBillingNotEnabledMapError
|
Błąd |
W projekcie nie włączono płatności. Musisz włączyć płatności w projekcie Google Cloud powiązanym z tym identyfikatorem klienta.Tutaj możesz to zrobić. |
BillingNotEnabledMapError
|
Błąd |
W projekcie nie włączono płatności, co jest przyczyną tego błędu. Musisz włączyć płatności w projekcie Google Cloud.Tutaj znajdziesz instrukcje. |
ExpiredKeyMapError
|
Błąd |
klucz interfejsu API zawarty w elemencie skryptu, który wczytuje interfejs API, wygasł lub nie jest rozpoznawany przez system; Ten błąd może się pojawić po utworzeniu nowego klucza interfejsu API, jeśli spróbujesz go użyć, zanim zostanie rozpoznany przez system. Poczekaj kilka minut i spróbuj ponownie. Być może musisz wygenerować nowy klucz API w konsoli Cloud Console. Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej.
|
InvalidAppCheckTokenMapError
|
Błąd |
Podany token Sprawdzania aplikacji jest nieprawidłowy lub wygasł. Ten błąd może wystąpić tylko wtedy, gdy używana jest weryfikacja za pomocą App Check. Zapoznaj się z przewodnikiem po weryfikacji funkcji Sprawdzanie aplikacji. |
InvalidClientIdMapError
|
Błąd |
Identyfikator klienta zawarty w elemencie skryptu, który wczytuje interfejs API, to jest nieprawidłowy lub stracił ważność. Upewnij się, że używasz identyfikatora klienta . Identyfikator klienta powinien zaczynać się od przedrostka „gme-”. Jeśli ten błąd pojawia się, mimo że prawidłowo używasz identyfikatora klienta, może to oznaczać, że identyfikator wygasł. Skontaktuj się ze swoim opiekunem klienta w Google.
Jeśli nie masz abonamentu Premium lub
Maps APIs for Work, musisz używać
Zobacz przewodnik Uwierzytelnianie w ramach abonamentu Premium. |
InvalidKeyMapError
|
Błąd |
Nie znaleziono klucza API zawartego w elemencie skryptu, który wczytuje interfejs API. Upewnij się, że używasz prawidłowego klucza interfejsu API. Dostępne opcje wygenerować nowy klucz interfejsu API w konsoli Cloud. Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej.
|
MalformedCredentialsMapError
|
Błąd |
Aplikacja używa nieobsługiwanego schematu identyfikatora URI. Sprawdź, czy aplikacja używa prawidłowy format identyfikatora URI zgodny z definicją w dokumencie RFC 3986. |
MissingKeyMapError
|
Błąd |
W elemencie skryptu, który wczytuje interfejs API, brakuje wymaganego parametru uwierzytelniania. Jeśli używasz standardowego interfejsu Maps JavaScript API, musisz użyć parametru Jeśli masz abonament Premium,
użyj parametru Jeśli NIE jesteś właścicielem witryny, nie możesz rozwiązać tego problemu . Jeśli to możliwe, poinformuj o tym właściciela witryny. |
ProjectDeniedMapError
|
Błąd |
Twoja prośba nie została zrealizowana. Więcej informacji o błędzie możesz znaleźć w Cloud Console. Zapoznaj się z Cloud Console. |
RefererDeniedMapError
|
Błąd |
Twoja aplikacja została zablokowana z powodu niezgodności z: Warunki korzystania z usługi Google Maps Platform po kilku e-mailach z powiadomieniami. Aby odwołać się od decyzji o zablokowaniu i poprosić o sprawdzenie implementacji, wypełnij ten formularz. Odpowiedź otrzymasz e-mailem w ciągu kilku dni roboczych. |
RefererNotAllowedMapError
|
Błąd |
Obecny adres URL, który wczytuje interfejs Maps JavaScript API, nie został została dodana do listy dozwolonych stron odsyłających. Sprawdź ustawienia odesłania klucza interfejsu API w Cloud Console. Zapoznaj się z interfejsem Maps JavaScript API oraz Uzyskaj klucz interfejsu API. |
OverQuotaMapError
|
Błąd |
Liczba żądań przekroczyła limity wykorzystania dla Maps JavaScript API. Żądania z aplikacji zaczną działać ponownie po następnym zresetowaniu limitu dziennego. Jeśli nie jesteś właścicielem witryny, nie możesz nic zrobić, aby naprawić ten błąd. Jeśli to możliwe, poinformuj o tym właściciela witryny. Więcej informacji znajdziesz w przewodniku dotyczącym limitów użytkowania. Znajdziesz tam też informacje o tym, jak zwiększyć limity wykorzystania. |
ApiProjectMapError
|
Błąd |
Podany klucz interfejsu API lub projekt interfejsu API, z którym jest powiązany, nie udało się rozwiązać. Ten błąd może być tymczasowy. Jeśli ten komunikat o błędzie będzie się powtarzać, konieczne może być uzyskanie nowego klucza interfejsu API lub utworzenie nowego projektu interfejsu API. Więcej informacji: Pierwsze kroki z Google Maps Platform |
ClientIdLooksLikeCryptoKey
|
Ostrzeżenie |
W parametrze Zapoznaj się z przewodnikiem dotyczącym identyfikatorów klienta dla klientów korzystających z abonamentu Premium i interfejsów API Map Google for Work. |
ClientIdLooksLikeKey
|
Ostrzeżenie |
W parametrze Zapoznaj się z przewodnikiem dotyczącym uwierzytelniania w ramach abonamentu premium. |
InvalidChannel
|
Ostrzeżenie |
Możliwe, że podano nieprawidłowy parametr Zobacz Raportowanie | Google Maps Platform w wersji premium. |
InvalidClientId
|
Ostrzeżenie |
Wygląda na to, że parametr Zobacz przewodnik Uwierzytelnianie w ramach abonamentu Premium. |
InvalidKey
|
Ostrzeżenie |
Klucz interfejsu API zawarty w elemencie skryptu, który wczytuje interfejs API, wygląda na nieprawidłowy. Upewnij się, że używasz prawidłowego klucza interfejsu API. Nowy klucz interfejsu API możesz wygenerować w konsoli Cloud. Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej.
|
InvalidVersion
|
Ostrzeżenie |
Możliwe, że w elemencie skryptu podano nieprawidłowy numer wersji. Upewnij się, że używasz prawidłowego numeru wersji. |
KeyLooksLikeClientId
|
Ostrzeżenie |
Możliwe, że jako parametr key został podany identyfikator klienta. Jeśli masz abonament Premium lub licencję na interfejsy Maps API for Work, jako parametr client podaj identyfikator klienta zamiast parametru key . Jeśli posiadasz
w wersji premium na Google Maps Platform, możesz używać parametru client .
lub parametr key . Jeśli nie masz żadnych licencji,
musisz użyć parametru key zamiast parametru client
.
Zapoznaj się z przewodnikiem dotyczącym uwierzytelniania w ramach abonamentu premium. |
KeyLooksLikeCryptoKey
|
Ostrzeżenie |
Jako parametr Zobacz przewodnik Określanie identyfikatora klienta podczas wczytywania interfejsu API. |
KeyLooksLikeProjectNumber
|
Ostrzeżenie |
Jako parametr Dowiedz się, jak uzyskać klucz API. |
NoApiKeys
|
Ostrzeżenie |
Element skryptu, który wczytuje interfejs API, nie ma klucza interfejsu API. Pamiętaj, aby w parametrze
Jeśli chcesz uzyskać klucz interfejsu API, kliknij przycisk poniżej.
Jeśli wczytujesz Maps JavaScript API z wycofanej wersji 2
ścieżki, otrzymasz ostrzeżenie |
RetiredVersion
|
Ostrzeżenie |
W swoim elemencie skryptu możesz mieć podany wycofany skrypt. Zaktualizuj aplikację tak, aby używała jednej z dostępnych wersji. |
SensorNotRequired
|
Ostrzeżenie |
Parametr |
SignatureNotRequired
|
Ostrzeżenie |
W przypadku interfejsu Maps JavaScript API parametr |
SignedInNotSupported
|
Ostrzeżenie |
Parametr |
UrlAuthenticationCommonError
|
Błąd |
Wystąpił błąd, który nie pasuje do żadnej z innych kategorii na tej stronie. Może to być spowodowane tymczasowym problemem. Ponów próbę po krótkim opóźnieniu. Jeśli to nie rozwiąże problemu, zapoznaj się z przewodnikiem dla deweloperów, aby sprawdzić, czy żądanie ma prawidłowy format. |
Sprawdzanie błędów w przeglądarce
Interfejs Maps JavaScript API zapisuje komunikaty o błędach w
window.console
W tej sekcji wyjaśniamy, jak sprawdzić
Dane wyjściowe window.console
w Google Chrome. Jeśli używasz innej przeglądarki, zapoznaj się z dokumentacją dla deweloperów tej przeglądarki. Dla
to lista narzędzi do sprawdzenia danych wyjściowych z window.console
w niektórych innych przeglądarkach.
- Konsola sieciowa w przeglądarce Firefox.
- Debugowanie zdalne na Androidzie.
- Web Inspector na iOS.
W Chrome możesz użyć konsoli JavaScriptu, aby sprawdzić dane wyjściowe window.console
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ę JavaScript, naciśnij klawisz ESC na klawiaturze. Klawisz ESC służy do włączania i wyłączania konsoli JavaScript. Jeśli zamkniesz konsolę, naciśnij ponownie klawisz ESC, aby go otworzyć.
Jeśli podczas wczytywania interfejsu Maps JavaScript API wystąpiły błędy lub ostrzeżenia, pojawią się one w postaci co najmniej 1 wiersza w konsoli. Komunikat o błędzie lub ostrzeżenie ma taki format:
Google Maps API error: [ERROR CODE] [Link to API document]
lub
Google Maps API warning: [ERROR CODE] [Link to API document]
W tabeli kodów błędów powyżej możesz znaleźć kod błędu w komunikacie o błędzie. Szczegółowe informacje o błędach znajdziesz też w dokumentacji interfejsu API, do której link znajduje się w wiadomości.
Uwaga: możesz odczytywać błędy uwierzytelniania za pomocą kodu.
Obsługa nieobsługiwanych przeglądarek
Upewnij się, że wersja przeglądarki, której używasz, jest obecnie obsługiwana przez interfejs Maps JavaScript API.
Jeśli tworzysz natywną aplikację na Windowsa, która działa w komponencie WebView, upewnij się, że używasz WebView2 w Edge. Poprzednie wersje WebView (oparte na Internet Explorerze) nie są już obsługiwane.
Jeśli kod nadal nie działa
Aby pomóc Ci w uruchomieniu kodu map, Brendan Kenny i Mano Marks wskazują w tym filmie kilka typowych błędów i sposoby ich naprawiania.
- Sprawdź, czy nie ma literówek. Pamiętaj, że w JavaScripcie wielkość liter ma znaczenie język.
- Sprawdź podstawy – niektóre z najczęstszych problemów występują podczas tworzenia mapy. Na przykład:
- Potwierdź, że w polu
zoom
została określona wartość icenter
miejsca zakwaterowania na Twojej mapie . - Upewnij się, że został zadeklarowany element div, w którym mapa widoczne na ekranie.
- Upewnij się, że element div mapy ma wysokość. Domyślnie Elementy div są tworzone o wysokości 0, dlatego są niewidoczny.
- Potwierdź, że w polu
- Użyj debugera JavaScriptu, aby zidentyfikować problemy, takie jak te dostępne w Narzędziach dla deweloperów w Chrome. Zacznij od wyszukania błędów w konsoli JavaScript.
- Publikuj pytania w Stosie Rozwiń menu. Wskazówki na temat publikowania świetnych pytań są dostępne na stronę Pomoc.