Komunikaty o błędach

Na tej stronie opisujemy komunikaty o błędach, które mogą być zwracane przez interfejs Maps JavaScript API. Interfejs Maps JavaScript API zapisuje komunikaty o błędach i ostrzeżenia w konsoli JavaScript. Mogą też wystąpić pewne błędy, które spowodują wyświetlenie przyciemnionej mapy ze znakiem wodnym.

Błędy związane z kluczem interfejsu API i płatnościami

Rozwiązywanie problemów

W określonych okolicznościach może się wyświetlić przyciemniona mapa lub „negatyw” obrazu Street View ze znakiem wodnym „for development purposes only” (tylko do celów programistycznych). Zwykle wskazuje to na problemy z kluczem interfejsu API lub rozliczeniami. Aby korzystać z usług Google Maps Platform, musisz włączyć płatności na swoim koncie, a wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Aby dowiedzieć się, jak znaleźć komunikaty o błędach, zapoznaj się z sekcją sprawdzania błędów w przeglądarce.

Poniższa procedura 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 listę możliwych kodów błędów zwracanych przez interfejs Maps JavaScript API wraz z opisem przyczyny i sposobem rozwiązania problemu. Aby dowiedzieć się, jak znaleźć komunikaty o błędach, zapoznaj się z sekcją sprawdzania błędów w przeglądarce.

Błędy wczytywania mapy

Jeśli podczas wczytywania interfejsu Maps JavaScript API wystąpi błąd, w tabeli poniżej znajdziesz wyjaśnienia kodów błędów.

Kod błędu Wiadomość Opis
NotLoadingAPIFromGoogleMapsError Interfejs Maps JavaScript API musi być pobierany bezpośrednio z serwerów Google.

Element skryptu, który wczytuje interfejs Maps JavaScript API, nie jest prawidłowo uwzględniony na stronie. Aby interfejs API działał prawidłowo, musi być wczytywany bezpośrednio z adresu https://maps.googleapis.com.

Zobacz Wczytywanie 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 nieprzestrzegania Warunków korzystania z usługi Google Maps Platform. Wcześniej wysłaliśmy do Ciebie kilka e-maili z powiadomieniami. Aby odwołać się od decyzji o zablokowaniu i poprosić o sprawdzenie wdrożenia, wypełnij ten formularz. Odpowiedź otrzymasz e-mailem w ciągu kilku dni roboczych.

Jeśli masz licencję na abonament Google Maps Platform Premium, użyj danych logowania do tego abonamentu, aby rozwiązać ten problem. 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.

Identyfikator klienta w ramach planu Premium lub interfejsów API Map Google dla firm dołączony do wczytywania skryptu jest nieprawidłowy lub wygasł. Adres bieżący wczytujący interfejs Maps JavaScript API nie został dodany do listy autoryzowanych adresów URL.

Zobacz Rejestracja autoryzowanych URL-i.

Kody błędów Maps JavaScript API

Jeśli w konsoli JavaScript w Chrome, konsoli sieciowej w Firefoksie lub w innych podobnych narzędziach w przeglądarkach znajdziesz błąd, zapoznaj się z tabelą poniżej, aby poznać 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. Twoja strona nie może prawidłowo wczytać interfejsu API, a interfejs API nie będzie na niej działać. Ostrzeżenie to dodatkowy komunikat dotyczący wczytywania interfejsu Maps JavaScript API. Ostrzeżenie opisuje możliwe przyczyny błędu lub sugeruje potencjalne problemy w kodzie, który wczytuje interfejs Maps JavaScript API. Jeśli otrzymasz tylko ostrzeżenia bez błędów, interfejs API będzie działać prawidłowo na tej stronie. Zalecamy jednak rozwiązanie również tych potencjalnych problemów.

Kod błędu dewelopera Typ Opis
ApiNotActivatedMapError Błąd

Interfejs Maps JavaScript API nie jest aktywowany w projekcie interfejsu API. Może być konieczne włączenie interfejsu Maps JavaScript API w sekcji Interfejsy API w konsoli Google Cloud.

Aby aktywować interfejs 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ń interfejsu API klucza interfejsu API w konsoli Google Cloud, aby upewnić się, że wszystkie interfejsy API i usługi, których chcesz używać, są prawidłowo określone na liście włączonych interfejsów API.

Zobacz Klucze interfejsu API w konsoli Cloud. Więcej informacji znajdziesz w artykule Sprawdzone metody dotyczące bezpieczeństwa interfejsów API.

DeletedApiProjectMapError Błąd

Twój projekt interfejsu API mógł zostać usunięty z konsoli Cloud. Sprawdź projekt, w którym został wygenerowany klucz interfejsu API dołączony do narzędzia do wczytywania interfejsu JavaScript API. Nowy projekt interfejsu API i nowy klucz możesz utworzyć w konsoli Cloud.

Aby utworzyć nowy projekt i uzyskać 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. Możesz to zrobić tutaj.

BillingNotEnabledMapError Błąd

W projekcie nie włączono płatności, co powoduje ten błąd. Musisz włączyć płatności w projekcie Google Cloud – możesz to zrobić tutaj.

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 wystąpić 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. Możesz też wygenerować nowy klucz interfejsu API w konsoli Cloud.

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

InvalidAppCheckTokenMapError Błąd

Podany token Sprawdzanie aplikacji jest nieprawidłowy lub wygasł. Ten błąd może wystąpić tylko wtedy, gdy używane jest weryfikacja Sprawdzanie aplikacji.

Zapoznaj się z przewodnikiem po weryfikacji za pomocą Sprawdzania aplikacji.

InvalidClientIdMapError Błąd

Aby zwiększyć bezpieczeństwo i niezawodność uwierzytelniania, 26 maja 2025 r. wycofaliśmy identyfikatory klienta Maps Platform. Po 31 maja 2026 r. nie będzie można ich już używać. Zamiast identyfikatora klienta musisz używać danych logowania klucza interfejsu API do uwierzytelniania ruchu w usłudze interfejs API Map Google.

Więcej informacji znajdziesz w przewodniku po migracji identyfikatora klienta. Wykonaj czynności opisane w przewodniku, aby tymczasowo przywrócić identyfikator klienta.

InvalidKeyMapError Błąd

Nie znaleziono klucza interfejsu API w elemencie skryptu, który wczytuje interfejs API. Sprawdź, czy 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

MalformedCredentialsMapError Błąd

Twoja aplikacja używa nieobsługiwanego schematu URI. Sprawdź, czy aplikacja używa prawidłowego formatu URI zdefiniowanego 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 prawidłowym kluczem interfejsu API. Więcej informacji znajdziesz w artykule Pierwsze kroki z Google Maps Platform.

Jeśli korzystasz z abonamentu Premium, musisz użyć parametru client z identyfikatorem klienta lub parametru key z prawidłowym kluczem interfejsu API. Więcej informacji znajdziesz w przewodniku po kluczach interfejsu API i identyfikatorach klienta.

Jeśli NIE jesteś właścicielem witryny, nie możesz podjąć żadnych działań, aby naprawić ten błąd. W miarę możliwości warto jednak powiadomić właściciela witryny.

ProjectDeniedMapError Błąd

Twoja prośba nie została zrealizowana. Więcej informacji o błędzie znajdziesz w konsoli Cloud.

Zobacz konsolę Cloud.

RefererDeniedMapError Błąd

Twoja aplikacja została zablokowana z powodu nieprzestrzegania Warunków korzystania z usługi Google Maps Platform. Wcześniej wysłaliśmy do Ciebie kilka e-maili z powiadomieniami. Aby odwołać się od decyzji o zablokowaniu i poprosić o sprawdzenie wdrożenia, wypełnij ten formularz. Odpowiedź otrzymasz e-mailem w ciągu kilku dni roboczych.

RefererNotAllowedMapError Błąd

Bieżący adres URL wczytujący interfejs Maps JavaScript API nie został dodany do listy dozwolonych odsyłających. Sprawdź ustawienia odsyłającego klucza interfejsu API w konsoli Cloud.

Zapoznaj się z interfejsem Maps JavaScript API i uzyskaj klucz interfejsu API.

OverQuotaMapError Błąd

Liczba żądań przekroczyła limity wykorzystania interfejsu Maps JavaScript API. Żądania aplikacji będą ponownie działać po następnym zresetowaniu limitu dziennego.

Jeśli NIE jesteś właścicielem witryny, nie możesz podjąć żadnych działań, aby naprawić ten błąd. W miarę możliwości powiadom właściciela witryny.

Więcej informacji znajdziesz w przewodniku po limitach wykorzystania. Na stronie znajdziesz też informacje o tym, jak zwiększyć limity wykorzystania.

ApiProjectMapError Błąd

Nie udało się rozpoznać podanego klucza interfejsu API ani projektu interfejsu API, z którym jest on powiązany. 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 znajdziesz w artykule Pierwsze kroki z Google Maps Platform.

ClientIdLooksLikeCryptoKey Ostrzeżenie

Być może w parametrze client podano klucz kryptograficzny. Jeśli masz abonament Premium lub licencję na interfejsy API Map Google dla firm, podaj identyfikator klienta jako parametr client. W przypadku interfejsu Maps JavaScript API nie musisz używać klucza kryptograficznego.

Zapoznaj się z przewodnikiem po identyfikatorach klienta dla klientów korzystających z abonamentu Premium i interfejsów API Map Google w wersji dla firm.

ClientIdLooksLikeKey Ostrzeżenie

Być może w parametrze client podano klucz interfejsu API. Jeśli masz abonament Premium lub licencję na interfejsy API Map Google dla firm, podaj identyfikator klienta jako parametr client. Jeśli masz abonament Google Maps Platform w wersji Premium, możesz użyć parametru client lub parametru key. Jeśli nie masz żadnych licencji, musisz użyć parametru key zamiast parametru client .

Zapoznaj się z przewodnikiem po uwierzytelnianiu 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ę (.), znak podkreślenia (_) i łącznik (-). Upewnij się, że podajesz prawidłowy parametr channel.

Zobacz Raportowanie | Google Maps Platform w abonamencie Premium.

InvalidClientId Ostrzeżenie

Parametr client nie zawiera prawidłowego identyfikatora klienta. Identyfikator klienta powinien zaczynać się od „gme-”.

Zapoznaj się z przewodnikiem po uwierzytelnianiu w ramach abonamentu Premium.

InvalidKey Ostrzeżenie

Klucz interfejsu API zawarty w elemencie skryptu, który wczytuje interfejs API, wygląda nieprawidłowo. Sprawdź, czy 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

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

Zobacz Obsługa wersji | Maps JavaScript API.

KeyLooksLikeClientId Ostrzeżenie Być może podano identyfikator klienta jako parametr key. Jeśli masz abonament Premium lub licencję na interfejsy Maps API for Work, podaj identyfikator klienta jako parametr client zamiast parametru key. Jeśli masz abonament Google Maps Platform w wersji Premium, możesz użyć parametru client lub parametru key. Jeśli nie masz żadnych licencji, musisz użyć parametru key zamiast parametru client .

Zapoznaj się z przewodnikiem po uwierzytelnianiu w ramach abonamentu Premium.

KeyLooksLikeCryptoKey Ostrzeżenie

Możesz podać klucz kryptograficzny lub tajny klucz podpisywania jako parametr key. Jeśli masz abonament Premium lub licencję na interfejsy API Map Google dla firm, podaj identyfikator klienta jako parametr client i usuń parametr key z elementu skryptu. Klucz kryptograficzny nie jest wymagany w przypadku interfejsu Maps JavaScript API. Jeśli masz abonament Google Maps Platform w wersji Premium, możesz użyć parametru client lub parametru key. Jeśli nie masz licencji, możesz uzyskać klucz API w konsoli Cloud.

Zapoznaj się z przewodnikiem po określaniu identyfikatora klienta podczas wczytywania interfejsu API.

KeyLooksLikeProjectNumber Ostrzeżenie

Być może numer projektu został podany jako parametr key. Sprawdź, czy używasz prawidłowego klucza interfejsu API. Nowy klucz interfejsu API możesz wygenerować 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. Upewnij się, że podajesz prawidłowy klucz interfejsu API jako parametr key. Nowy klucz interfejsu API możesz wygenerować w konsoli Cloud.

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

Jeśli wczytujesz interfejs Maps JavaScript API ze ścieżki v2, która jest już wycofana, zobaczysz ostrzeżenie NoApiKeys, nawet jeśli podasz parametr key. Zapoznaj się z przewodnikiem po przejściu z wersji 2 na wersję 3 i przeprowadź migrację aplikacji do interfejsu Maps JavaScript API w wersji 3.

RetiredVersion Ostrzeżenie

W elemencie skryptu mogła zostać podana wycofana wersja. Zaktualizuj aplikację, aby korzystać z jednej z dostępnych wersji.

Zobacz Obsługa wersji | Maps JavaScript API.

SensorNotRequired Ostrzeżenie

Parametr sensor nie jest już wymagany w przypadku interfejsu Maps JavaScript API. Nie uniemożliwi to prawidłowego działania interfejsu Maps JavaScript API, ale zalecamy usunięcie parametru sensor z elementu skryptu.

SignatureNotRequired Ostrzeżenie

Parametr signature nie jest wymagany w przypadku interfejsu Maps JavaScript API. Nie uniemożliwi to prawidłowego działania interfejsu Maps JavaScript API, ale może stwarzać zagrożenia dla bezpieczeństwa. 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 uniemożliwi to działania interfejsu Maps JavaScript API, ale jeśli korzystasz z funkcji wymagających zalogowania, zachowanie aplikacji może się zmienić.

UrlAuthenticationCommonError Błąd

Wystąpił błąd, który nie pasuje do żadnej z pozostałych kategorii na tej stronie. Może to być spowodowane chwilowym problemem. Spróbuj ponownie po krótkiej przerwie. Jeśli to nie rozwiąże problemu, zapoznaj się z przewodnikiem dla deweloperów, aby upewnić się, że żądanie ma odpowiedni format.

Sprawdzanie błędów w przeglądarce

Interfejs Maps JavaScript API zapisuje komunikaty o błędach w window.console. Z tej sekcji dowiesz się, jak sprawdzić window.console dane wyjściowe w Google Chrome. Jeśli używasz innych przeglądarek, zapoznaj się z dokumentacją dla deweloperów. Dla Twojej wygody podajemy listę narzędzi do sprawdzania window.console w innych przeglądarkach.

W Chrome możesz użyć konsoli JavaScript, 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 włącza i wyłącza konsolę JavaScript. Jeśli zamkniesz konsolę, naciśnij ponownie klawisz ESC, aby ją otworzyć.

Jeśli podczas wczytywania interfejsu Maps JavaScript API wystąpiły błędy lub ostrzeżenia, pojawią się one w konsoli w postaci co najmniej 1 wiersza. Komunikat o błędzie lub ostrzeżenie ma format:

Google Maps API error: [ERROR CODE] [Link to API document]
lub
Google Maps API warning: [ERROR CODE] [Link to API document]

tabeli kodów błędów powyżej możesz znaleźć kod błędu w komunikacie o błędzie. Szczegóły dotyczące komunikatu o błędzie znajdziesz też w dokumencie interfejsu API, do którego link znajduje się w tym komunikacie.

Uwaga: możesz nasłuchiwać błędów uwierzytelniania programowo.

Obsługa nieobsługiwanych przeglądarek

Sprawdź, czy używana wersja przeglądarki jest obecnie obsługiwana przez interfejs Maps JavaScript API.

Jeśli tworzysz natywną aplikację na Windowsa, która działa w komponencie WebView, używaj WebView2 opartego na Edge. Starsze wersje WebView oparte na Internet Explorerze nie są już obsługiwane.

Jeśli kod nadal nie działa

W tym filmie Brendan Kenny i Mano Marks wskazują typowe błędy i wyjaśniają, jak je naprawić, aby kod mapy działał prawidłowo.

  • Sprawdź, czy nie ma literówek. Pamiętaj, że w JavaScript rozróżniana jest wielkość liter.
  • Sprawdź podstawy – niektóre z najczęstszych problemów występują podczas początkowego tworzenia mapy. Na przykład:
    • Sprawdź, czy w opcjach mapy zostały określone właściwości zoomcenter.
    • Sprawdź, czy zadeklarowano element div, w którym mapa będzie wyświetlana na ekranie.
    • Upewnij się, że element div mapy ma wysokość. Domyślnie elementy div mają wysokość 0, więc są niewidoczne.
    Zapoznaj się z naszymi przykładami, aby zobaczyć implementację referencyjną.
  • Użyj debugera JavaScriptu, aby zidentyfikować problemy, np. tego dostępnego w Narzędziach dla programistów w Chrome. Zacznij od sprawdzenia, czy w konsoli JavaScriptu nie ma błędów.
  • Zadawaj pytania na Stack Overflow. Wskazówki dotyczące zadawania dobrych pytań znajdziesz na stronie Pomoc.