Places UI Kit: gotowa do użycia biblioteka, która zapewnia programistom możliwość dostosowywania i kontrolowania. Wypróbuj go i podziel się opinią na temat korzystania z interfejsu UI Kit.

Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

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 komunikaty o błędach i ostrzeżeniach w konsoli JavaScriptu. Mogą też wystąpić pewne błędy, które powodują wyświetlenie przyciemnionej mapy ze znakiem wodnym.

Błędy dotyczące klucza interfejsu API i płatności

Rozwiązywanie problemów

W pewnych okolicznościach może wyświetlać się przyciemniona mapa lub „negatyw” zdjęcia Street View ze znakiem wodnym z tekstem „tylko do celów programistycznych”. Takie działanie zwykle wskazuje na problemy z kluczem interfejsu API lub płatnościami. Aby korzystać z usług Google Maps Platform, musisz mieć włączone płatności na koncie, a wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Aby dowiedzieć się, jak znaleźć komunikaty o błędach, zapoznaj się z sekcją dotyczącą sprawdzania błędów w przeglądarce.

Poniższy proces 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 jako parametr key w adresie URL używanym do wczytywania interfejsu Maps JavaScript API. Oto kilka opcji, które możesz sprawdzić, jeśli używasz klucza interfejsu API:

Użyj rozszerzenia do Chrome Google Maps Platform API Checker. Dzięki temu możesz sprawdzić, czy Twoja witryna prawidłowo implementuje licencjonowane 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 widzisz te komunikaty, oznacza to, że nie używasz klucza interfejsu API prawidłowo:
- Ostrzeżenie interfejsu Google Maps JavaScript API: NoApiKeys
- Błąd interfejsu Maps JavaScript API Map Google: MissingKeyMapError

Dla programistów stron internetowych:

Jeśli masz dostęp do kodu źródłowego aplikacji, poszukaj tagu <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 interfejsu API.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Sprawdź ruch w sieci generowany przez Twoją witrynę w przeglądarce. W Chrome można to sprawdzić na karcie Sieć w DevTools. Zobaczysz tu żądania sieciowe wysyłane przez Twoją witrynę. Żądania wysyłane za pomocą Maps JavaScript API będą miały ścieżkę maps/api/js. Tutaj możesz sprawdzić, czy żądania używają parametru key. Podczas wyświetlania karty Sieć warto przefiltrować ruch w sieci według maps/api/js.

Nie, nie używam klucza interfejsu API.

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

Tak, używam klucza interfejsu API.

Świetnie. Przejdźmy dalej i sprawdźmy, czy do projektu jest dołączone konto rozliczeniowe.

Czy do projektu jest dołączone konto rozliczeniowe?

Tego nie wiem. Jak mogę sprawdzić, czy do mojego projektu jest dołączone konto rozliczeniowe?

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

Otwórz sekcję Dane logowania, która jest dostępna na pasku bocznym po lewej stronie w sekcji Google Maps Platform > Dane logowania.
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.
Jeśli nie możesz znaleźć projektu dla klucza interfejsu API, być może nie masz już do niego dostępu. Poproś o pomoc inne osoby w organizacji. Jeśli nie możesz znaleźć pierwotnego projektu:
1. Utwórz nowy projekt. Możesz to zrobić, wybierając Nowy projekt na liście projektów lub Utwórz projekt na stronie Menedżera zasobów.
2. Tworzenie nowego klucza interfejsu API Możesz to zrobić na stronie Dane logowania. Kliknij Utwórz dane logowania, a następnie wybierz Klucz interfejsu API.

Po znalezieniu projektu w konsoli Cloud sprawdź, czy jest do niego dołączone konto rozliczeniowe. W tym celu przejdź do sekcji Płatności w menu po lewej stronie.

Nie, do mojego projektu nie jest dołą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 Pierwsze kroki z Google Maps Platform.

Tak, do mojego projektu jest dołączone konto rozliczeniowe.

Świetnie. Sprawdź, 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ść)?

W konsoli Cloud możesz dodać, usunąć lub zaktualizować formę płatności.

Czy został przekroczony samodzielnie nałożony limit dzienny interfejsu API?

Jeśli masz ustawiony limit dzienny dla dowolnego interfejsu API, co jest powszechną praktyką zapobiegającą nieoczekiwanym wzrostom, możesz rozwiązać ten problem, zwiększając limit dzienny.

Limity dzienne możesz sprawdzić w panelu Interfejsy API i usługi w konsoli Cloud. Wtedy:

Jeśli pojawi się taka prośba, wybierz projekt.
Wybierz interfejs API z listy, a następnie kliknij kartę Limity.

Czy klucz interfejsu API ma ograniczenie dotyczące adresów IP?

Kluczy interfejsu API z ograniczeniem Adresy IP można używać tylko z usługami internetowymi przeznaczonymi do użytku po stronie serwera (takimi jak Geocoding API i inne interfejsy API usług internetowych). Większość tych usług internetowych ma odpowiedniki w Maps JavaScript API (np. usługa geokodowania). Aby korzystać z usług po stronie klienta Maps JavaScript API, musisz utworzyć osobny klucz interfejsu API, który można zabezpieczyć za pomocą ograniczenia Strony odsyłające HTTP (patrz Uzyskiwanie, dodawanie i ograniczanie klucza interfejsu API).

Kody błędów interfejsu Maps JavaScript API dla deweloperów i właścicieli witryn

W tabelach poniżej znajdziesz kody błędów, które mogą być zwracane przez 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ą dotyczącą sprawdzania 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 poniższą tabelą, aby znaleźć objaśnienia kodów błędów.

Kod błędu Wiadomość Opis

Kod błędu	Wiadomość	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 uwzględniony na stronie. Aby interfejs API działał prawidłowo, musi być wczytywany bezpośrednio z 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 niezgodności z Warunkami korzystania z usługi Google Maps Platform, po wysłaniu kilku e-maili z powiadomieniami. Aby odwołać się od blokady i poprosić o sprawdzenie implementacji, wypełnij formularz odwołania dotyczący Warunków korzystania z Google Maps Platform. Odpowiedź otrzymasz e-mailem w ciągu kilku dni roboczych. Aby rozwiązać ten problem, użyj klucza interfejsu API lub identyfikatora klienta. Zapoznaj się z przewodnikiem po kluczach interfejsu API i identyfikatorach klienta.
`UnauthorizedURLForClientIdMapError`	Ten adres URL nie ma uprawnień do używania podanego identyfikatora klienta Map Google.	Identyfikator klienta podany podczas wczytywania skryptu jest nieprawidłowy lub wygasł albo bieżący adres, który wczytuje interfejs Maps JavaScript API, nie został dodany do listy autoryzowanych adresów URL. Zobacz Rejestrowanie autoryzowanych adresów URL.

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 uwzględniony na stronie. Aby interfejs API działał prawidłowo, musi być wczytywany bezpośrednio z 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 niezgodności z Warunkami korzystania z usługi Google Maps Platform, po wysłaniu kilku e-maili z powiadomieniami. Aby odwołać się od blokady i poprosić o sprawdzenie implementacji, wypełnij formularz odwołania dotyczący Warunków korzystania z Google Maps Platform. Odpowiedź otrzymasz e-mailem w ciągu kilku dni roboczych.

Aby rozwiązać ten problem, użyj klucza interfejsu API lub identyfikatora klienta. Zapoznaj się z przewodnikiem po kluczach interfejsu API i identyfikatorach klienta.

UnauthorizedURLForClientIdMapError

Ten adres URL nie ma uprawnień do używania podanego identyfikatora klienta Map Google.

Identyfikator klienta podany podczas wczytywania skryptu jest nieprawidłowy lub wygasł albo bieżący adres, który wczytuje 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 w konsoli JavaScriptu w Chrome, konsoli internetowej Firefoksa lub innym podobnym narzędziu w przeglądarce pojawi się błąd, w tabeli poniżej znajdziesz objaśnienia kodów błędów.

Maps JavaScript API zwraca zarówno błędy, jak i ostrzeżenia. Błąd oznacza 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 dotyczący wczytywania interfejsu Maps JavaScript API. Ostrzeżenie opisuje możliwe przyczyny błędu lub sugeruje 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ć prawidłowo na tej stronie. Zalecamy jednak, aby rozwiązać również te potencjalne problemy.

Kod błędu dewelopera	Typ	Opis
`ApiNotActivatedMapError`	Błąd	Interfejs Maps JavaScript API nie jest aktywowany w projekcie interfejsu API. Być może musisz włączyć Maps JavaScript API w sekcji Interfejsy API w konsoli Google Cloud. Aby aktywować Maps JavaScript API w 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 dla klucza interfejsu API w konsoli Google Cloud, aby upewnić się, że wszystkie interfejsy API i usługi, których potrzebujesz, 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 dotyczących bezpieczeństwa interfejsów API.
`DeletedApiProjectMapError`	Błąd	Projekt interfejsu API mógł zostać usunięty z konsoli Cloud. Sprawdź projekt, dla którego został wygenerowany klucz interfejsu API zawarty w module ładującym interfejsu 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	W projekcie nie włączono płatności. Musisz włączyć płatności w projekcie Google Cloud powiązanym z tym identyfikatorem klienta.
`BillingNotEnabledMapError`	Błąd	Ten błąd występuje, ponieważ w projekcie nie włączono płatności. Musisz włączyć płatności w projekcie Google Cloud. 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. Rozpocznij
`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ą Sprawdzania 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. Nie będzie można ich używać po 31 maja 2026 r. Zamiast identyfikatora klienta musisz używać danych uwierzytelniających klucza interfejsu API, aby uwierzytelniać ruch w usłudze interfejsu API Map Google. Więcej informacji znajdziesz w przewodniku po migracji identyfikatora klienta. Postępuj zgodnie z instrukcjami podanymi w przewodniku, aby tymczasowo przywrócić identyfikator klienta.
`InvalidKeyMapError`	Błąd	Nie znaleziono klucza interfejsu API zawartego 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 zdefiniowanego w dokumencie RFC 3986.
`MissingKeyMapError`	Błąd	W elemencie skryptu, który wczytuje interfejs API, brakuje wymaganego parametru uwierzytelniania. Jeśli używasz 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 używasz identyfikatora klienta, 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 nic zrobić, aby naprawić ten błąd. Jeśli to możliwe, możesz jednak powiadomić 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 konsolę Cloud.
`RefererDeniedMapError`	Błąd	Twoja aplikacja została zablokowana z powodu niezgodności z Warunkami korzystania z usługi Google Maps Platform, po wysłaniu kilku e-maili z powiadomieniami. Aby odwołać się od blokady i poprosić o sprawdzenie implementacji, wypełnij formularz odwołania dotyczący Warunków korzystania z Google Maps Platform. Odpowiedź otrzymasz e-mailem w ciągu kilku dni roboczych.
`RefererNotAllowedMapError`	Błąd	Bieżący adres URL, który wczytuje 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 Maps JavaScript API i uzyskaj klucz interfejsu API.
`OverQuotaMapError`	Błąd	Liczba żądań przekroczyła limity wykorzystania Maps JavaScript API. Żądania aplikacji zaczną ponownie działać po kolejnym 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, możesz jednak powiadomić właściciela witryny. Więcej informacji znajdziesz w przewodniku po limitach wykorzystania. Na tej stronie dowiesz się też, jak zwiększyć limity wykorzystania.
`ApiProjectMapError`	Błąd	Nie udało się rozpoznać podanego klucza interfejsu API lub powiązanego z nim projektu interfejsu API. Ten błąd może być tymczasowy. Jeśli ten komunikat o błędzie będzie się powtarzał, może być konieczne 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. Podaj identyfikator klienta jako parametr `client`. Nie musisz używać klucza kryptograficznego w przypadku interfejsu Maps JavaScript API. Zapoznaj się z przewodnikiem po identyfikatorach klientów.
`ClientIdLooksLikeKey`	Ostrzeżenie	Być może w parametrze `client` podano klucz interfejsu API. Podaj identyfikator klienta jako parametr `client` lub użyj parametru `key` z prawidłowym kluczem interfejsu API zamiast parametru `client`. Zapoznaj się z przewodnikiem po kluczach interfejsu API i identyfikatorach klienta.
`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 \| Google Maps Platform.
`InvalidClientId`	Ostrzeżenie	Wygląda na to, że parametr `client` nie zawiera prawidłowego identyfikatora klienta. Identyfikator klienta powinien zaczynać się od „gme-”. Zapoznaj się z przewodnikiem po kluczach interfejsu API i identyfikatorach klienta.
`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	Być może w elemencie skryptu podano nieprawidłowy numer wersji. Upewnij się, że używasz prawidłowego numeru wersji. Zobacz Wersje \| Maps JavaScript API.
`KeyLooksLikeClientId`	Ostrzeżenie	Być może identyfikator klienta został podany jako parametr `key`. Podaj identyfikator klienta jako parametr `client` zamiast parametru `key` lub użyj parametru `key` z prawidłowym kluczem interfejsu API. Zapoznaj się z przewodnikiem po kluczach interfejsu API i identyfikatorach klienta.
`KeyLooksLikeCryptoKey`	Ostrzeżenie	Być może klucz kryptograficzny lub tajny klucz podpisu został podany jako parametr `key`. Podaj identyfikator klienta jako parametr `client` i usuń parametr `key` z elementu skryptu. Klucz kryptograficzny nie jest wymagany w przypadku interfejsu Maps JavaScript API. Możesz też uzyskać klucz interfejsu API w konsoli Cloud i użyć parametru `key`. Zapoznaj się z przewodnikiem Określanie identyfikatora klienta podczas wczytywania interfejsu API.
`KeyLooksLikeProjectNumber`	Ostrzeżenie	Być może numer projektu został podany jako parametr `key`. 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. 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. Rozpocznij Jeśli wczytujesz Maps JavaScript API z wycofanej ścieżki wersji 2, zobaczysz ostrzeżenie `NoApiKeys`, nawet jeśli podasz parametr `key`. Zapoznaj się z przewodnikiem po uaktualnianiu z wersji 2 do wersji 3 i przenieś swoją aplikację do interfejsu Maps JavaScript API w wersji 3.
`RetiredVersion`	Ostrzeżenie	Być może w elemencie skryptu podano wycofaną wersję. Zaktualizuj aplikację, aby używać jednej z dostępnych wersji. Zobacz Wersje \| 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żenie 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, której używasz. Nie uniemożliwi to działania interfejsu Maps JavaScript API, ale może zmienić działanie aplikacji, jeśli korzystasz z funkcji wymagających zalogowania.
`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 tymczasowym 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 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 dowiesz się, jak sprawdzić dane wyjściowe window.console w Google Chrome. Jeśli używasz innych przeglądarek, zapoznaj się z dokumentacją dla deweloperów dotyczącą Twojej przeglądarki. Oto lista narzędzi, które pozwalają sprawdzić dane wyjściowe window.console w innych przeglądarkach.

Konsola sieciowa w przypadku Firefoksa.
Zdalne debugowanie na Androidzie.
Web Inspector na iOS.

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

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

Jeśli podczas wczytywania 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 następujący format:

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

Możesz sprawdzić tabelę kodów błędów powyżej, aby znaleźć kod błędu w komunikacie o błędzie. Szczegółowe informacje o komunikacie o błędzie znajdziesz też w dokumentacji interfejsu API, do której link znajduje się w komunikacie.

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

Obsługa nieobsługiwanych przeglądarek

Upewnij się, że używana wersja przeglądarki jest obsługiwana przez Maps JavaScript API.

Jeśli tworzysz aplikację na komputery z systemem Windows, która działa w komponencie WebView, upewnij się, że używasz komponentu WebView2 opartego na przeglądarce 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.

Upewnij się, że adres nie zawiera literówek. Pamiętaj, że w języku JavaScript wielkość liter ma znaczenie.
Sprawdź podstawowe kwestie – niektóre z najczęstszych problemów występują podczas tworzenia mapy. Na przykład:
- Sprawdź, czy w opcjach mapy zostały określone właściwości zoom i center.
- Upewnij się, że masz zadeklarowany element div, w którym mapa będzie wyświetlana na ekranie.
- Upewnij się, że element div mapy ma określoną wysokość. Domyślnie elementy div są tworzone z wysokością 0, więc są niewidoczne.
Przykłady znajdziesz w implementacji referencyjnej.
Aby zidentyfikować problemy, użyj debugera JavaScriptu, np. dostępnego w Narzędziach deweloperskich w Chrome. Zacznij od sprawdzenia, czy w konsoli JavaScriptu nie ma błędów.
Zadawaj pytania na Stack Overflow. Wskazówki dotyczące publikowania dobrych pytań znajdziesz na stronie Pomoc.