Komunikaty o błędach

Potrzebujesz pomocy człowieka?
Otwórz stronę pomocy Google Maps Platform.
Ta strona z komunikatami o błędach ma charakter wyłącznie informacyjny. Pomoże Ci ona samodzielnie rozwiązać problemy z błędami interfejsu Maps JavaScript API. Jeśli spróbujesz poprosić o pomoc kogoś, przesyłając opinię na tej stronie, nie dotrzesz do nikogo, kto mógłby Ci pomóc. Jeśli jednak zauważysz problem z treścią na tej stronie, poinformuj nas o tym, korzystając z linku do przesyłania opinii. Dziękujemy!

Na tej stronie opisujemy komunikaty o błędach, które może zwrócić interfejs Maps JavaScript API. Interfejs Maps JavaScript API zapisuje komunikaty o błędach i ostrzeżenia w konsoli JavaScript. Mogą również wystąpić pewne błędy, które skutkują wyświetlaniem ciemniejszej mapy zawierającej znaki wodne.

Jeśli NIE jesteś właścicielem witryny, nie możesz nic zrobić, aby naprawić którykolwiek z tych błędów. Warto jednak powiadomić o tym właściciela witryny.

Klucz interfejsu API i błędy rozliczeniowe

Rozwiązywanie problemów

W pewnych okolicznościach przyciemniona mapa lub „negatywne” zdjęcie Street View może się wyświetlać ze znakiem wodnym z tekstem „tylko do celów programistycznych”. Takie zachowanie zwykle oznacza problemy z kluczem interfejsu API lub płatnościami. Aby korzystać z usług Google Maps Platform, musisz włączyć na koncie płatności, a wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Informacje o znajdowaniu komunikatów o błędach znajdziesz w sekcji poświęconej sprawdzaniu błędów w przeglądarce.

Ta procedura pomoże Ci rozwiązać problem.

Czy używasz klucza interfejsu API?

Tego nie wiem. Jak mogę sprawdzić, czy używam klucza interfejsu API?

Klucz interfejsu API jest przekazywany w adresie URL jako parametr key, który służy do wczytywania interfejsu Maps JavaScript API. Oto kilka sposobów sprawdzenia, czy używasz klucza interfejsu API:

• Użyj rozszerzenia do Chrome Google Maps Platform API Checker. Dzięki temu możesz określić, czy Twoja witryna prawidłowo wdraża licencjonowane przez Google interfejsy API Map Google.
• Jeśli do wczytywania interfejsu Maps JavaScript API używasz biblioteki lub wtyczki, sprawdź ustawienia tej biblioteki i poszukaj opcji klucza interfejsu API.
• Sprawdź błędy w przeglądarce. Jeśli pojawiają się te komunikaty, oznacza to, że nieprawidłowo używasz klucza interfejsu API:
• Ostrzeżenie Google Maps JavaScript API: NoApiKeys
• Błąd interfejsu Google Maps JavaScript API: MissingKeyMapError

Dla programistów stron internetowych:

• Jeśli masz dostęp do kodu źródłowego swojej aplikacji, znajdź tag <script>, który służy do wczytywania interfejsu Maps JavaScript API. Podczas wczytywania interfejsu Maps JavaScript API zastąp YOUR_API_KEY w poniższym kodzie swoim kluczem API.

    <script async defer
      src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
    </script>
  

• Sprawdź w przeglądarce ruch w sieci generowany przez Twoją witrynę. W Chrome możesz go wyświetlić na karcie Sieć w DevTools. Zobaczysz na niej żądania sieciowe wysyłane przez Twoją witrynę. Żądania wykonane za pomocą interfejsu Maps JavaScript API będą mieć ścieżkę maps/api/js. Tutaj możesz sprawdzić, czy żądania używają parametru key. Podczas wyświetlania karty Sieć pomocne może być filtrowanie ruchu sieciowego według wartości maps/api/js.

Nie, nie używam klucza interfejsu API.

Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej. Jeśli nie widzisz instrukcji konfiguracji, postępuj zgodnie z pełnymi instrukcjami w artykule Pierwsze kroki z Google Maps Platform.
Rozpocznij

Tak, używam klucza interfejsu API.

Świetnie. Sprawdźmy teraz, czy z Twoim projektem jest powiązane konto rozliczeniowe.

Czy do Twojego projektu jest połączone konto rozliczeniowe?

Tego nie wiem. Jak sprawdzić, czy z moim projektem jest powiązane konto rozliczeniowe?

Otwórz stronę Płatności w konsoli Google Cloud i wybierz projekt, w którym utworzono klucz interfejsu API. Aby potwierdzić, że klucz jest powiązany z projektem:

1. Przejdź do sekcji Dane logowania, którą znajdziesz na pasku bocznym po lewej stronie w sekcji Google Maps Platform > Dane logowania.
2. Sprawdź, czy klucz interfejsu API, którego obecnie używasz w witrynie, znajduje się na liście. Jeśli tak nie jest, przełącz się na inny projekt i sprawdź dane logowania.
3. Jeśli nie możesz znaleźć projektu odpowiadającego kluczowi interfejsu API, być może nie masz do niego dostępu. Poproś o pomoc innych użytkowników w organizacji. Jeśli nie możesz znaleźć oryginalnego projektu:
   1. Utwórz nowy projekt. Aby to zrobić, wybierz Nowy projekt na liście projektów lub kliknij Utwórz projekt na stronie Menedżera zasobów.
   2. Tworzenie nowego klucza interfejsu API Możesz to zrobić na stronie Dane logowania. Następnie kliknij Utwórz dane logowania i wybierz Klucz interfejsu API.

Po znalezieniu projektu w Cloud Console otwórz sekcję Płatności w menu po lewej stronie i sprawdź, czy jest połączone konto rozliczeniowe.

Nie, do mojego projektu nie jest połączone konto rozliczeniowe.

Otwórz stronę Włącz płatności w konsoli Cloud i dodaj konto rozliczeniowe do projektu. Więcej informacji znajdziesz w artykule o pierwszych krokach z Google Maps Platform.

Tak, z moim projektem jest powiązane konto rozliczeniowe.

Świetnie. Sprawdźmy, czy podana forma płatności jest prawidłowa.

Czy podana forma płatności jest już nieważna (np. karta kredytowa straciła ważność)?

Formę płatności możesz dodać, usunąć lub zaktualizować w Cloud Console.

Czy istnieje limit dzienny nałożony przez siebie na interfejs API?

Jeśli masz ustawiony dzienny limit któregoś z interfejsów API, co zwykle pozwala uniknąć nieoczekiwanych wzrostów, możesz rozwiązać ten problem, zwiększając dzienny limit.

Limity dzienne możesz sprawdzić w panelu interfejsów API i usług w Cloud Console. Gdy to zrobisz:

1. Wybierz projekt, jeśli pojawi się taka prośba.
2. Wybierz z listy interfejs API i kliknij kartę Limity.

Czy Twój klucz interfejsu API ma ograniczenie adresów IP?

Klucze interfejsu API z ograniczeniem adresów IP można używać tylko w usługach internetowych przeznaczonych do działania po stronie serwera (takich jak Geocoding API i inne interfejsy API usług internetowych). Większość z tych usług internetowych ma odpowiadające im usługi w interfejsie Maps JavaScript API (zobacz na przykład usługę geokodowania). Aby korzystać z usług po stronie klienta interfejsu Maps JavaScript API, musisz utworzyć oddzielny klucz interfejsu API, który można zabezpieczyć za pomocą ograniczenia Strony odsyłające HTTP (patrz Pobieranie, dodawanie i ograniczanie klucza interfejsu API).

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 zwracane przez interfejs Maps JavaScript API oraz ich przyczyny i sposoby rozwiązania problemu. Informacje o znajdowaniu komunikatów o błędach znajdziesz w sekcji poświęconej sprawdzaniu błędów w przeglądarce.

Błędy wczytywania mapy

Jeśli napotkasz błąd podczas wczytywania interfejsu Maps JavaScript API, zapoznaj się z tabelą poniżej, gdzie znajdziesz objaśnienia kodów błędów.

Kod błędu	przekaz,	Opis
NotLoadingAPIFromGoogleMapsError	Interfejs Maps JavaScript API musi zostać pobrany bezpośrednio z serwerów Google.	Element skryptu, który wczytuje interfejs Maps JavaScript API, nie jest prawidłowo umieszczony na stronie. Aby interfejs API działał prawidłowo, musi zostać wczytany bezpośrednio z 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 dla tej witryny.	Twoja aplikacja została zablokowana z powodu niezgodności z Warunkami korzystania z usługi Google Maps Platform po otrzymaniu kilku e-maili z powiadomieniem. Aby odwołać się od blokady i poprosić o sprawdzenie implementacji, wypełnij ten formularz. Odpowiedź otrzymasz e-mailem w ciągu kilku dni roboczych. Jeśli masz licencję na abonament Premium Google Maps Platform, użyj danych logowania w abonamencie Premium Google Maps Platform, aby rozwiązać ten problem. Zapoznaj się z przewodnikiem po uwierzytelnianiu w abonamencie Premium.
UnauthorizedURLForClientIdMapError	Ten URL nie ma uprawnień do korzystania z podanego identyfikatora klienta Map Google.	Identyfikator klienta abonamentu Premium lub interfejsu API Map Google podany przy wczytywaniu skryptu jest nieprawidłowy, wygasł lub obecny adres, który wczytuje interfejs Maps JavaScript API, nie został dodany do listy autoryzowanych adresów URL. Więcej informacji znajdziesz w artykule Rejestrowanie autoryzowanych adresów URL.

Kody błędów interfejsu Maps JavaScript API

Jeśli w konsoli JavaScript Chrome, konsoli Firefox Web Console lub w innych odpowiednich narzędziach w przeglądarce pojawia się błąd, zapoznaj się z poniższą tabelą, gdzie znajdziesz wyjaśnienia dotyczące 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 działać na tej stronie. Ostrzeżenie to dodatkowa wiadomość dotycząca wczytywania interfejsu Maps JavaScript API. Ostrzeżenie zawiera opis możliwych przyczyn błędu lub sugeruje potencjalne problemy w kodzie, które ładują interfejs Maps JavaScript API. Jeśli będziesz otrzymywać tylko ostrzeżenia bez żadnych błędów, interfejs API będzie działać na tej stronie prawidłowo. Zalecamy jednak rozwiązanie tych potencjalnych problemów.

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 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ń interfejsów API klucza interfejsu API w konsoli Google Cloud, aby mieć pewność, że wszystkie interfejsy API i usługi, których potrzebujesz do korzystania, 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 o sprawdzonych metodach zapewniania bezpieczeństwa interfejsów API.
DeletedApiProjectMapError	Błąd	Twój projekt API mógł zostać usunięty z Cloud Console. Sprawdź projekt, dla którego wygenerowano klucz interfejsu API uwzględniony w programie ładującym JavaScript API. Możesz utworzyć nowy projekt interfejsu API i uzyskać 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ć płatności w projekcie Google Cloud powiązanym z tym identyfikatorem klienta tutaj.
BillingNotEnabledMapError	Błąd	W projekcie nie włączono płatności, co jest przyczyną tego błędu. Płatności w projekcie Google Cloud musisz włączyć tutaj. Więcej informacji
ExpiredKeyMapError	Błąd	Klucz interfejsu API zawarty w elemencie skryptu, który wczytuje interfejs API, wygasł lub nie został rozpoznany przez system. Ten błąd może wystąpić po utworzeniu nowego klucza interfejsu API, jeśli próbujesz użyć go, zanim zostanie on rozpoznany przez system. Zaczekaj kilka minut i spróbuj jeszcze raz. Może być też konieczne wygenerowanie nowego klucza interfejsu API w konsoli Cloud. Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej. Rozpocznij
InvalidClientIdMapError	Błąd	Identyfikator klienta zawarty w elemencie skryptu, który wczytuje interfejs API, jest nieprawidłowy lub wygasł. Sprawdź, czy prawidłowo używasz identyfikatora klienta. Identyfikator klienta powinien zaczynać się od „gme-”. Jeśli widzisz ten błąd, nawet jeśli prawidłowo używasz identyfikatora klienta, może to oznaczać, że identyfikator klienta wygasł. Skontaktuj się ze swoim opiekunem klienta w Google. Jeśli nie masz abonamentu Premium ani licencji na interfejsy API Map Google, musisz użyć z kluczem interfejsu API parametru key, a nie parametru client . Zapoznaj się z przewodnikiem po uwierzytelnianiu w abonamencie Premium.
InvalidKeyMapError	Błąd	Nie znaleziono klucza interfejsu API uwzględnionego w elemencie skryptu, który wczytuje interfejs API. 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. Rozpocznij
MalformedCredentialsMapError	Błąd	Twoja aplikacja używa nieobsługiwanego schematu URI. Sprawdź, czy aplikacja używa prawidłowego formatu identyfikatora URI, zgodnie z definicją w RFC 3986.
MissingKeyMapError	Błąd	W elemencie skryptu, który wczytuje interfejs API, brakuje wymaganego parametru uwierzytelniania. Jeśli korzystasz ze standardowego interfejsu Maps JavaScript API, musisz użyć parametru key z prawidłowym kluczem interfejsu API. Więcej informacji znajdziesz w artykule o pierwszych krokach z Google Maps Platform. Jeśli korzystasz z abonamentu Premium, musisz używać parametru client z identyfikatorem klienta lub parametru key z prawidłowym kluczem interfejsu API. Więcej informacji znajdziesz w przewodniku dotyczącym kluczy interfejsu API i identyfikatorów klienta. Jeśli NIE jesteś właścicielem witryny, nie możesz nic zrobić, aby naprawić ten błąd. Warto jednak powiadomić 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 konsoli Cloud. Zobacz Cloud Console.
RefererDeniedMapError	Błąd	Twoja aplikacja została zablokowana z powodu niezgodności z Warunkami korzystania z usługi Google Maps Platform po otrzymaniu kilku e-maili z powiadomieniem. Aby odwołać się od blokady 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 wczytujący interfejs Maps JavaScript API nie został dodany do listy dozwolonych stron odsyłających. Sprawdź ustawienia strony odsyłającej klucza interfejsu API w konsoli Cloud. Zobacz opis interfejsu Maps JavaScript API i dowiedz się, jak uzyskać klucz interfejsu API.
OverQuotaMapError	Błąd	Liczba żądań przekroczyła limity wykorzystania interfejsu Maps JavaScript API. Żądania Twojej aplikacji będą działać ponownie 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. Warto jednak powiadomić o tym właściciela witryny. Więcej informacji znajdziesz w przewodniku po limitach wykorzystania. Na tej stronie znajdziesz też informacje o tym, jak uzyskać wyższe limity wykorzystania.
ApiProjectMapError	Błąd	Nie udało się znaleźć podanego klucza interfejsu API lub projektu 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ł, być może trzeba będzie uzyskać nowy klucz interfejsu API lub utworzyć nowy projekt API. Więcej informacji znajdziesz w artykule o pierwszych krokach 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, podaj swój identyfikator klienta jako parametr client. W przypadku interfejsu Maps JavaScript API nie musisz używać klucza kryptograficznego. Zapoznaj się z przewodnikiem po identyfikatorach klientów dla klientów korzystających z abonamentu Premium i interfejsów API Map Google.
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, podaj identyfikator klienta jako parametr client. Jeśli masz abonament Premium Google Maps Platform, możesz używać parametru client lub key. Jeśli nie masz żadnych licencji, zamiast parametru client musisz użyć parametru key. Zapoznaj się z przewodnikiem po uwierzytelnianiu w abonamencie Premium.
InvalidChannel	Ostrzeżenie	Być moż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 podajesz prawidłowy parametr channel. Zobacz Raportowanie | abonament Premium Google Maps Platform.
InvalidClientId	Ostrzeżenie	Wygląda na to, że parametr client zawiera nieprawidłowy identyfikator klienta. Identyfikator klienta powinien zaczynać się od „gme-”. Zapoznaj się z przewodnikiem po uwierzytelnianiu w abonamencie 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. Rozpocznij
InvalidVersion	Ostrzeżenie	Możliwe, że element skryptu zawiera nieprawidłowy numer wersji. Upewnij się, że używasz prawidłowego numeru wersji. Więcej informacji znajdziesz na stronie Obsługa wersji | Google Maps JavaScript API.
KeyLooksLikeClientId	Ostrzeżenie	Być może jako parametr key podano identyfikator klienta. Jeśli masz abonament Premium lub licencję na interfejsy API Map Google, podaj swój identyfikator klienta jako parametr client zamiast key. Jeśli masz abonament Premium Google Maps Platform, możesz używać parametru client lub key. Jeśli nie masz żadnych licencji, zamiast parametru client musisz użyć parametru key. Zapoznaj się z przewodnikiem po uwierzytelnianiu w abonamencie Premium.
KeyLooksLikeCryptoKey	Ostrzeżenie	Być może jako parametr key podano klucz kryptograficzny lub tajny klucz podpisywania. Jeśli masz abonament Premium lub licencję na interfejsy API Map Google, podaj swój identyfikator klienta jako parametr client i usuń parametr key z elementu skryptu. Interfejs Maps JavaScript API nie wymaga klucza kryptograficznego. Jeśli masz abonament Premium Google Maps Platform, możesz używać parametru client lub key. Jeśli nie masz żadnych licencji, możesz uzyskać klucz interfejsu API w Cloud Console. Zapoznaj się z przewodnikiem dotyczącym określania identyfikatora klienta podczas wczytywania interfejsu API.
KeyLooksLikeProjectNumber	Ostrzeżenie	Być może w parametrze key podano numer projektu. Upewnij się, że 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. Jako parametr key dodaj prawidłowy klucz interfejsu API. Nowy klucz interfejsu API możesz wygenerować w konsoli Cloud. Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej. Rozpocznij Jeśli wczytujesz Maps JavaScript API z wycofanej ścieżki w wersji 2, zobaczysz ostrzeżenie NoApiKeys, nawet jeśli określisz parametr key. Zapoznaj się z przewodnikiem po uaktualnianiu z wersji 2 do 3 i przenieś aplikację do Maps JavaScript API w wersji 3.
RetiredVersion	Ostrzeżenie	Element skryptu może zawierać wycofaną wersję. Zaktualizuj aplikację, aby używała jednej z dostępnych wersji. Więcej informacji znajdziesz na stronie Obsługa wersji | Google Maps JavaScript API.
SensorNotRequired	Ostrzeżenie	Parametr sensor nie jest już wymagany w przypadku interfejsu Maps JavaScript API. W przeciwnym razie interfejs Maps JavaScript API nie będzie działać prawidłowo, 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 poprawnego działania interfejsu Maps JavaScript API, ale może zagrażać bezpieczeństwu. Usuń go z elementu skryptu.
SignedInNotSupported	Ostrzeżenie	Parametr signed_in został wycofany i nie jest obsługiwany w używanej przez Ciebie wersji interfejsu Maps JavaScript API. Nie uniemożliwia to działania interfejsu Maps JavaScript API, ale może się zmienić działanie aplikacji, jeśli będziesz korzystać z funkcji po zalogowaniu.
UrlAuthenticationCommonError	Błąd	Wystąpił błąd, który nie pasuje do innych kategorii na tej stronie. Może to być spowodowane tymczasowym problemem. Spróbuj jeszcze raz z krótkim opóźnieniem. Jeśli to nie rozwiąże problemu, zapoznaj się z przewodnikiem dla programistó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 interfejsie window.console. W tej sekcji dowiesz się, jak sprawdzić dane wyjściowe window.console w Google Chrome. Jeśli używasz innych przeglądarek, zapoznaj się z dokumentacją ich programistów. W celach informacyjnych znajdziesz listę narzędzi, które pozwolą Ci sprawdzić dane wyjściowe wartości window.console w niektórych innych przeglądarkach.

• Konsola internetowa dla Firefoksa.
• Zdalne debugowanie w przypadku Androida.
• Inspektor sieci na iOS.

W Chrome możesz za pomocą konsoli JavaScript 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. Klawisz ESC przełączy konsolę JavaScript. Jeśli zamkniesz konsolę, naciśnij ponownie klawisz ESC.

Jeśli podczas wczytywania interfejsu Maps JavaScript API wystąpiły błędy lub ostrzeżenia, są one wyświetlane w konsoli jako co najmniej jeden wiersz. 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]

Aby znaleźć kod błędu w komunikacie o błędzie, zajrzyj do tabeli z kodami błędów powyżej. Szczegółowe informacje o komunikacie o błędzie znajdziesz też w dokumencie API, do którego link znajdziesz w wiadomości.

Uwaga: możesz wykrywać błędy uwierzytelniania automatycznie.

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ę dla systemu Windows, która uruchamia się w WebView, upewnij się, że używasz WebView2 w oparciu o Edge. Poprzednie wersje komponentu WebView opartego na Internet Explorerze nie są już obsługiwane.

Jeśli kod nadal nie działa

Aby pomóc Ci w utworzeniu kodu w Mapach, Brendan Kenny i Mano Marks pokazują w tym filmie kilka typowych błędów i sposoby ich naprawy.

• Sprawdź, czy nie ma literówek. Pamiętaj, że w języku JavaScript rozróżniana jest wielkość liter.
• Sprawdź podstawy – niektóre z najczęstszych problemów występują przy początkowym tworzeniu mapy. Na przykład:
  • Potwierdź, że w opcjach mapy zostały określone właściwości zoom i center.
  • Pamiętaj, aby zadeklarować element div, w którym mapa wyświetli się na ekranie.
  • Sprawdź, czy element div mapy ma wysokość. Domyślnie elementy div mają wysokość 0 i dlatego są niewidoczne.
  Informacje o implementacji znajdziesz w przykładach.
• Użyj debugera JavaScriptu, aby zidentyfikować problemy (takie jak ten dostępny w Narzędziach deweloperskich w Chrome). Zacznij od wyszukania błędów w konsoli JavaScript.
• Opublikuj pytania w Stack Overflow. Wytyczne na temat publikowania ciekawych pytań znajdziesz na stronie Pomoc.