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.
|
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.
|
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. |
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.
|
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.
|
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 Jeśli korzystasz z abonamentu Premium, musisz użyć parametru 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 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 Zapoznaj się z przewodnikiem po uwierzytelnianiu w ramach abonamentu Premium. |
InvalidChannel
|
Ostrzeżenie |
Możliwe, że podano nieprawidłowy parametr Zobacz Raportowanie | Google Maps Platform w abonamencie Premium. |
InvalidClientId
|
Ostrzeżenie |
Parametr 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.
|
InvalidVersion
|
Ostrzeżenie |
W elemencie skryptu podano nieprawidłowy numer wersji. Upewnij się, że używasz prawidłowego numeru wersji. |
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 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 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
Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej.
Jeśli wczytujesz interfejs Maps JavaScript API ze ścieżki v2, która jest już wycofana, zobaczysz ostrzeżenie |
RetiredVersion
|
Ostrzeżenie |
W elemencie skryptu mogła zostać podana wycofana wersja. Zaktualizuj aplikację, aby korzystać z jednej z dostępnych wersji. |
SensorNotRequired
|
Ostrzeżenie |
Parametr |
SignatureNotRequired
|
Ostrzeżenie |
Parametr |
SignedInNotSupported
|
Ostrzeżenie |
Parametr |
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.
- Konsola sieciowa w Firefoxie.
- Zdalne debugowanie na Androidzie.
- Inspektora sieci na iOS.
W Chrome możesz użyć konsoli JavaScript, 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 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]
W 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
zoomicenter. - 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.
- Sprawdź, czy w opcjach mapy zostały określone właściwości
- 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.