Komunikaty o błędach

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.

Zobacz Wczytywanie interfejsu Maps JavaScript API.

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.

Zobacz Rejestrowanie 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.
Więcej informacji

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.
Więcej informacji

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.

Więcej informacji

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.
Pierwsze kroki

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ć key za pomocą klucza interfejsu API zamiast parametru client .

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.
Pierwsze kroki

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 key z poprawnym kluczem interfejsu API. Więcej informacji: Pierwsze kroki z Google Maps Platform

Jeśli masz abonament Premium, użyj parametru client z identyfikatorem klienta lub key z prawidłowym kluczem interfejsu API. Więcej informacji znajdziesz w przewodniku Klucze API i identyfikatory klienta.

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 client mogłeś podać klucz kryptograficzny. Jeśli masz subskrypcję Premium lub Licencja Maps APIs for Work (podaj poniżej) identyfikator klienta jako parametr client. Nie musisz użyć swojego klucza kryptograficznego dla Maps JavaScript API.

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 client możesz podać klucz interfejsu API. Jeśli masz subskrypcję Premium lub Licencja Maps APIs for Work, określ klienta Identyfikator jako parametr client. Jeśli masz abonament premium Google Maps Platform, możesz użyć parametru client lub 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.

InvalidChannel Ostrzeżenie

Możliwe, że podano nieprawidłowy parametr channel. kanał musi być ciągiem alfanumerycznym ASCII, który może zawierać kropkę (.), podkreślenie (_) i łącznik (-). Upewnij się, że określający prawidłowy parametr channel.

Zobacz Raportowanie | Google Maps Platform w wersji premium.

InvalidClientId Ostrzeżenie

Wygląda na to, że parametr client nie zawiera prawidłowego identyfikatora klienta. Identyfikator klienta powinien zaczynać się od „gme-”.

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.
Pierwsze kroki

InvalidVersion Ostrzeżenie

Możliwe, że w elemencie skryptu podano nieprawidłowy numer wersji. Upewnij się, że używasz prawidłowego numeru wersji.

Zobacz Obsługa wersji | Interfejs Maps JavaScript API.

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 key możesz podać klucz kryptograficzny lub tajny klucz podpisywania. Jeśli masz subskrypcję Premium lub Licencja Maps APIs for Work (podaj poniżej) identyfikatora klienta jako parametru client i usuń parametr key z elementu skryptu. Klucz kryptograficzny jest nie jest wymagane w przypadku interfejsu Maps JavaScript API. Jeśli masz abonament premium Google Maps Platform, możesz użyć parametru client lub key. Jeśli nie masz licencji, możesz uzyskać klucz API w Cloud Console.

Zobacz przewodnik Określanie identyfikatora klienta podczas wczytywania interfejsu API.

KeyLooksLikeProjectNumber Ostrzeżenie

Jako parametr key możesz podać numer projektu. Upewnij się, że używasz prawidłowego klucza interfejsu API. Możesz wygenerować nowy klucza interfejsu API w konsoli Cloud.

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 key podać prawidłowy klucz interfejsu API. Nowy klucz interfejsu API możesz wygenerować w konsoli Cloud.

Jeśli chcesz uzyskać klucz interfejsu API, kliknij przycisk poniżej.
Pierwsze kroki

Jeśli wczytujesz Maps JavaScript API z wycofanej wersji 2 ścieżki, otrzymasz ostrzeżenie NoApiKeys, nawet jeśli określisz parametru key. Przejrzyj Przewodnik po przejściu z wersji 2 na 3 i przenieść ją do Maps JavaScript API v3.

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.

Zobacz Obsługa wersji | Google Maps JavaScript API.

SensorNotRequired Ostrzeżenie

Parametr sensor nie jest już wymagany w interfejsie Maps JavaScript API. Nie zapobiega to Maps JavaScript API nie działa prawidłowo, ale zalecamy usunięcie parametru sensor z elementu skryptu.

SignatureNotRequired Ostrzeżenie

W przypadku interfejsu Maps JavaScript API parametr signature nie jest wymagany. Nie zapobiega to Maps JavaScript API nie działa prawidłowo, ale może mogą zagrażać bezpieczeństwu. Usuń go z elementu skryptu.

SignedInNotSupported Ostrzeżenie

Parametr signed_in został wycofany i nie jest obsługiwany w wersji interfejsu Maps JavaScript API, z której korzystasz. Nie spowoduje to wyłączenia interfejsu Maps JavaScript API, ale działanie aplikacji może się zmienić, jeśli korzystasz z funkcji wymagających zalogowania.

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.

W Chrome możesz użyć konsoli JavaScriptu, aby sprawdzić dane wyjściowe window.console w ten sposób:

  1. Aby otworzyć Narzędzia dla deweloperów, kliknij ikonę menu > Więcej narzędzi > Narzędzia dla deweloperów.
  2. 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ść i center 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.
    Zapoznaj się z naszych przykładami, aby zobaczyć, jak wygląda implementacja referencyjna.
  • 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.