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 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 pewnych okolicznościach może się wyświetlać przyciemniona mapa lub „negatyw” zdjęcia Street View ze znakiem wodnym z tekstem „for development purposes only” (tylko do celów programistycznych). Zwykle oznacza to problemy z kluczem interfejsu API lub płatnościami. Aby korzystać z usług Google Maps Platform, musisz mieć włączone rozliczenia na koncie, a wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Więcej informacji o tym, jak znaleźć komunikaty o błędach, znajdziesz w sekcji Sprawdzanie błędów w przeglądarce.

Poniższa 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 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 zobaczysz te komunikaty, oznacza to, że nie używasz klucza interfejsu API prawidłowo:

Ostrzeżenie dotyczące 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ą interfejsu Maps JavaScript API będą znajdować się w ścieżce maps/api/js. W tym miejscu 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.
Pierwsze kroki

Tak, używam klucza interfejsu API.

Świetnie. Sprawdźmy teraz, czy do Twojego projektu jest dołączone konto rozliczeniowe.

Czy z Twoim projektem jest połą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, do której możesz przejść z paska bocznego 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 klikając Utwórz projekt na stronie Resource Manager.
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 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, z moim projektem nie jest powiązane żadne konto rozliczeniowe.

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

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

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

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

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

Czy przekroczono 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.

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

Jeśli pojawi się monit, 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 sieciowymi przeznaczonymi do użytku po stronie serwera (takimi jak Geocoding API i inne interfejsy API usług sieciowych). Większość tych usług sieciowych ma odpowiedniki w Maps JavaScript API (np. usługa geokodowania). Aby korzystać z usług po stronie klienta interfejsu Maps JavaScript API, musisz utworzyć osobny klucz interfejsu API, który można zabezpieczyć za pomocą ograniczenia odsyłających adresów 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 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ą 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, w tabeli poniżej znajdziesz wyjaś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 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 kilka e-maili z powiadomieniami. Aby odwołać się od blokady i poprosić o sprawdzenie implementacji, wypełnij ten formularz. W ciągu kilku dni roboczych otrzymasz odpowiedź e-mailem. Aby rozwiązać ten problem, użyj klucza interfejsu API lub danych logowania 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 uwzględniony w skrypcie wczytywania jest nieprawidłowy lub wygasł, albo bieżący adres wczytujący 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 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 kilka e-maili z powiadomieniami. Aby odwołać się od blokady i poprosić o sprawdzenie implementacji, wypełnij ten formularz. W ciągu kilku dni roboczych otrzymasz odpowiedź e-mailem.

Aby rozwiązać ten problem, użyj klucza interfejsu API lub danych logowania 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 uwzględniony w skrypcie wczytywania jest nieprawidłowy lub wygasł, albo bieżący adres wczytujący 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 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 oznacza poważny problem, który wystąpił podczas wczytywania interfejsu Maps JavaScript API. Strona nie może prawidłowo wczytać interfejsu API, który 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 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. 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 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 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, w którym został wygenerowany klucz interfejsu API dołączony do narzędzia do wczytywania 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. 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 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 pojawić się 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żywane jest Sprawdzanie aplikacji. Zapoznaj się z przewodnikiem po weryfikacji Sprawdzania aplikacji.
`InvalidClientIdMapError`	Błąd	Aby zwiększyć bezpieczeństwo i niezawodność uwierzytelniania, identyfikatory klienta Maps Platform zostały wycofane 26 maja 2025 r. i 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. Wykonaj czynności opisane 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. 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 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 podjąć żadnych działań, aby naprawić ten błąd. Warto jednak powiadomić właściciela witryny, jeśli jest to możliwe.
`ProjectDeniedMapError`	Błąd	Twoja prośba nie została zrealizowana. Więcej informacji o błędzie znajdziesz w konsoli Cloud. Więcej informacji znajdziesz w konsoli Cloud.
`RefererDeniedMapError`	Błąd	Twoja aplikacja została zablokowana z powodu niezgodności z Warunkami korzystania z usługi Google Maps Platform. Wcześniej wysłaliśmy kilka e-maili z powiadomieniami. 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	Bieżący adres URL, który wczytuje interfejs Maps JavaScript API, nie został dodany do listy dozwolonych stron odsyłających. Sprawdź ustawienia odsyłającego klucza interfejsu API w konsoli Cloud. Zobacz 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 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ę nadal wyświetlać, 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 klienta.
`ClientIdLooksLikeKey`	Ostrzeżenie	Być może klucz interfejsu API został podany w parametrze `client`. Określ 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	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 podajesz prawidłowy parametr `channel`. Zobacz Raportowanie \| Google Maps Platform.
`InvalidClientId`	Ostrzeżenie	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, nie wygląda na prawidłowy. 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 mogła zostać podana nieprawidłowa wersja. 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 obiekt tajny podpisu został podany jako parametr `key`. Określ 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 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 przenieś aplikację na interfejs 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 \| Google 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 spowodować zagrożenie 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 prośba 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.consolewynik w Google Chrome. Jeśli używasz innej przeglądarki, zapoznaj się z jej dokumentacją dla deweloperów. Dla Twojej wygody podajemy listę narzędzi do sprawdzania window.console w innych przeglądarkach.

Konsola sieciowa w przypadku przeglądarki Firefox.
Zdalne debugowanie na Androidzie.
Inspektor sieci 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 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 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]

W tabeli kodów błędów powyżej możesz 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łędy uwierzytelniania programowo.

Obsługa nieobsługiwanych przeglądarek

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

Jeśli tworzysz natywną aplikację na Windowsa, która działa w komponencie WebView, upewnij się, że używasz WebView2 opartego na 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 podane właściwości zoom i center.
- Upewnij się, że masz zadeklarowany element div, w którym mapa będzie wyświetlana na ekranie.
- Sprawdź, czy element div mapy ma wysokość. Domyślnie elementy div są tworzone z wysokością 0, więc są niewidoczne.
Zapoznaj się z naszymi przykładami, aby zobaczyć implementację referencyjną.
Użyj debugera JavaScript, aby łatwiej identyfikować problemy, np. tego dostępnego w Narzędziach dla deweloperów 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.