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. Określony błąd mogą również wystąpić warunki, które skutkują zaciemnieniem mapa ze znakiem wodnym.

Klucz interfejsu API i błędy rozliczeniowe

Rozwiązywanie problemów

W pewnych okolicznościach zaciemniona mapa lub wynik „negatywny” zdjęcie Street View ze znakiem wodnym z tekstem „tylko do celów programistycznych”, może być wyświetlana. Zwykle oznacza to problemy z kluczem interfejsu API lub płatnościami. Aby móc korzystać z usług Google Maps Platform, płatności muszą być włączone na koncie, a wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Informacje o znajdowaniu komunikatów 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 tabelach poniżej znajdziesz możliwe kody błędów zwracanych przez Maps JavaScript API wraz z opisem przyczyny i możliwości rozwiązań 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, Wyjaśnienia kodów błędów znajdziesz w tabeli poniżej.

Kod błędu Wiadomość Opis
NotLoadingAPIFromGoogleMapsError Interfejs Maps JavaScript API należy pobrać bezpośrednio z serwerów.

Elementem skryptu, który wczytuje interfejs Maps JavaScript API, jest nie są poprawnie uwzględnione na stronie. Aby interfejs API mógł działać musi być wczytywany bezpośrednio z https://maps.googleapis.com.

Zobacz Wczytuję 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 dla tej witryny.

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 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. Zobacz przewodnik Uwierzytelnianie w ramach abonamentu Premium.

UnauthorizedURLForClientIdMapError Ten URL nie ma uprawnień do korzystania z podanego identyfikatora klienta Map Google.

abonament Premium lub Maps API for Work, identyfikator klienta zawarty w wczytywaniu skryptu jest nieprawidłowy, wygasła lub bieżący adres wczytuje do Interfejs Maps JavaScript API nie został dodany do listy autoryzowane URL-e.

Zobacz Rejestrowanie autoryzowanych adresów URL

Kody błędów Maps JavaScript API

Jeśli znajdziesz błąd w przeglądarce Chrome JavaScript Konsola, Firefox konsola internetowa lub podobne narzędzia w przeglądarce, Wyjaśnienia kodów błędów znajdziesz w tabeli poniżej.

Interfejs Maps JavaScript API zwraca zarówno błędy, jak i ostrzeżenia. Błąd oznacza poważny problem, który wystąpił podczas wczytywania Maps JavaScript API. Strona nie może poprawnie wczytać interfejsu API, a interfejs API nie będzie działać na tej stronie. 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 naprawienie tych .

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: Sprawdzone metody zabezpieczania interfejsów API

DeletedApiProjectMapError Błąd

Twój projekt API mógł zostać usunięty z Cloud Console. Sprawdź projekt, dla którego został wygenerowany klucz interfejsu API zawarte w programie wczytującym JavaScript API. 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

Nie masz włączonych płatności w projekcie. Musisz włączyć Rozliczenia w Google Cloud Projekt powiązany z tym identyfikatorem klienta, tutaj.

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.

Więcej informacji

ExpiredKeyMapError Błąd

Klucz interfejsu API zawarty w elemencie skryptu, który wczytuje interfejs API, ma wygasła lub nie została rozpoznana 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. Zaczekaj chwilę i spróbuj ponownie. Może być też konieczne wygenerowanie nowego klucza interfejsu API Konsola Cloud.

Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej.
Pierwsze kroki

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 „gme-” . Jeśli zobaczysz komunikat ten błąd, nawet jeśli używasz poprawnie identyfikatora klienta, może on straciły ważność. 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

Klucz interfejsu API zawarty w elemencie skryptu, który wczytuje interfejs API, nie jest . 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, użyj parametr key z prawidłowym 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 interfejsu API i identyfikatory klientów.

Jeśli NIE jesteś właścicielem witryny, nie możesz rozwiązać tego problemu . Warto jednak powiadomić o tym właściciela witryny, jeśli będzie to możliwe.

ProjectDeniedMapError Błąd

Twoja prośba nie została zrealizowana. Możesz znaleźć więcej o błędzie w konsoli Google Cloud.

Zobacz konsolę Cloud.

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 zablokuj i poproś o sprawdzenie implementacji, dokończ 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ź stronę odsyłającą klucza interfejsu API w konsoli Cloud.

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. Prośby z aplikacji znów będą działać przy następnym zresetowaniu limitu dziennego.

Jeśli NIE jesteś właścicielem witryny, nie musisz nic robić, napraw ten błąd. Warto jednak powiadomić o tym właściciela witryny, jeśli będzie to możliwe.

Więcej informacji znajdziesz w przewodniku limity wykorzystania. Na stronie znajdziesz też informacje o tym, jak podnieść 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 może być konieczne uzyskanie nowego klucza interfejsu API lub utworzenie nowego projektu API.

Więcej informacji: Pierwsze kroki z Google Maps Platform

ClientIdLooksLikeCryptoKey Ostrzeżenie

Możliwe, że client przekazał(a) Ci 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.

Zobacz przewodnik klient identyfikatory wersji Premium oraz Klienci Google Maps API for Work.

ClientIdLooksLikeKey Ostrzeżenie

Możliwe, że w parametrze client został podany klucz interfejsu API. Jeśli masz subskrypcję Premium lub Licencja Maps APIs for Work – określ klienta Identyfikator jako parametr client. 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 .

Zobacz przewodnik Uwierzytelnianie 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 poprawnej wartości identyfikatora klienta. Identyfikator klienta powinien zaczynać się od „gme-”.

Zobacz przewodnik Uwierzytelnianie w ramach abonamentu Premium.

InvalidKey Ostrzeżenie

Klucz interfejsu API umieszczony w elemencie skryptu, który wczytuje interfejs API, nie wyglądają dobrze. 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 | Google Maps JavaScript API.

KeyLooksLikeClientId Ostrzeżenie Możliwe, że jako parametr key został podany identyfikator klienta. Jeśli masz abonament Premium lub Licencja Maps APIs for Work. Podaj swój identyfikator klienta jako client 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 .

Zobacz przewodnik Uwierzytelnianie w ramach abonamentu Premium.

KeyLooksLikeCryptoKey Ostrzeżenie

Możliwe, że otrzymaliśmy od Ciebie klucz kryptograficzny lub tajny klucz podpisywania jako key . 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 posiadasz w wersji premium na Google Maps Platform, możesz używać parametru client. lub parametr key. Jeśli nie masz żadnych licencji, uzyskać klucz interfejsu API w konsoli Cloud.

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

KeyLooksLikeProjectNumber Ostrzeżenie

Możliwe, że jako parametr key został podany 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 interfejsu API.

NoApiKeys Ostrzeżenie

Element skryptu, który wczytuje interfejs API, nie ma klucza interfejsu API. Sprawdź, czy podasz prawidłowy klucz interfejsu API jako parametr key. 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

Możliwe, że w elemencie skryptu znajdują się wycofane wersje. 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 przypadku parametru 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

Parametr signature nie jest wymagany w przypadku parametru Maps JavaScript API. 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 tej wersji interfejsu Maps JavaScript API, którego używasz. Nie zapobiegnie to kierowaniu Maps JavaScript API nie działa, ale działanie aplikacji może się zmienić. jeśli korzystasz z funkcji po zalogowaniu się.

UrlAuthenticationCommonError Błąd

Wystąpił błąd, który nie pasuje do innych kategorii w tej stronę. 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 przewodnik dla programistów aby sprawdzić, czy żądanie ma właściwy 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 innego zapoznaj się z dokumentacją dla deweloperów dotyczącą danej przeglądarki. Na to lista narzędzi do sprawdzenia danych wyjściowych z narzędzia window.console w niektórych innych przeglądarkach.

W Chrome możesz użyć funkcji Konsola JavaScript aby sprawdzić dane wyjściowe funkcji window.console w następujący sposób.

  1. Aby otworzyć Narzędzia dla programistów, kliknij ikonę menu > Więcej narzędzi > Narzędzia dla programistów.
  2. Aby otworzyć konsolę JavaScript, naciśnij klawisz ESC. Klawisz ESC przełącza między konsolą JavaScriptu. Jeśli zamkniesz konsolę, naciśnij ponownie klawisz ESC, aby go otworzyć.

Jeśli podczas wczytywania Maps JavaScript API, są widoczne jako co najmniej jeden wiersz 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 znajdziesz informacje kod błędu w komunikacie o błędzie. Znajdziesz tam też informacje na temat w dokumencie API, do którego link znajduje się w wiadomości.

Uwaga: możesz nasłuchiwanie błędów uwierzytelniania automatycznie.

Obsługa nieobsługiwanych przeglądarek

Upewnij się, że używana przez Ciebie wersja przeglądarki to obecnie obsługiwane przez Maps JavaScript API.

Jeśli tworzysz natywną aplikację dla systemu Windows, która działa w komponencie WebView, korzysta z opartego na 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 na mapie, Brendan Kenny i Mano Marks wskazują o najczęstszych błędach i sposobach ich naprawy.

  • 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 dotyczą przy tworzeniu 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 naszymi przykładami odwołanie
  • Użyj debugera JavaScriptu, aby zidentyfikować problemy, takie jak ten, który może być dostępny W przeglądarce Chrome Narzędzia dla programistów. 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.