Ta strona została przetłumaczona przez Cloud Translation API.

Komunikaty o błędach

Na tej stronie opisujemy komunikaty o błędach, które może zostać zwrócony przez interfejs API JavaScript Map Google. Interfejs Maps JavaScript API zapisuje komunikaty o błędach i ostrzeżenia w konsoli JavaScript. Mogą też wystąpić pewne błędy, które skutkują wyświetleniem ciemnej, oznaczonej mapy.

Błędy klucza interfejsu API i błędy płatności

Rozwiązywanie problemów

W określonych okolicznościach może być wyświetlana ciemna mapa, czyli „negatywna” grafika Street View, zawierająca tekst „tylko do celów programistycznych”. To zachowanie zazwyczaj oznacza problemy z kluczem interfejsu API lub płatnościami. Aby korzystać z usług Google Maps Platform, musisz mieć włączone na koncie płatności i wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Informacje o tym, jak znaleźć komunikaty o błędach, znajdziesz w sekcji dotyczącej sprawdzania błędów w przeglądarce.

Ten 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żywany do wczytywania interfejsu Maps JavaScript API. Oto kilka sposobów sprawdzenia, czy używasz klucza interfejsu API:

Użyj rozszerzenia do Chrome Narzędzie do sprawdzania interfejsu API Google Maps Platform. Pozwoli Ci to 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 pojawią się te komunikaty, nie korzystasz prawidłowo z klucza interfejsu API:

Ostrzeżenie dotyczące interfejsu API JavaScript Map Google: NoApiKeys
Błąd interfejsu API JavaScript Map Google: MissingKeyMapError

Dla programistów stron internetowych:

Jeśli masz dostęp do kodu źródłowego 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 kodzie poniżej.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Sprawdź ruch generowany przez Twoją witrynę w przeglądarce. W Chrome możesz to sprawdzić na karcie Narzędzia dla deweloperów w sekcji Sieć. Tutaj zobaczysz żądania sieciowe wysłane przez Twoją witrynę. Żądania wykonane za pomocą interfejsu Maps JavaScript API będą wysyłane pod ścieżką maps/api/js. Tutaj możesz sprawdzić, czy żądania używają parametru key. Podczas wyświetlania karty Sieć możesz przefiltrować ruch w sieci 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 z instrukcjami, wykonaj pełne instrukcje opisane w artykule Pierwsze kroki z Google Maps Platform.
Rozpocznij

Tak, używam klucza interfejsu API.

Świetnie. Przejdźmy dalej i sprawdź, czy z Twoim projektem jest powiązane konto rozliczeniowe.

Czy z Twoim projektem jest połączone konto rozliczeniowe?

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

Otwórz stronę Rozliczenia w Google Cloud Console i wybierz projekt, w którym został utworzony klucz interfejsu API. Aby sprawdzić, czy klucz jest powiązany z projektem:

Przejdź do sekcji Dane logowania, którą znajdziesz na pasku bocznym po lewej stronie w sekcji Google Maps Platform > Dane logowania.
Sprawdź, czy na liście znajduje się klucz interfejsu API, którego używasz obecnie w swojej witrynie. W przeciwnym razie przełącz się na inny projekt i sprawdź dane logowania.
Jeśli nie możesz znaleźć projektu dla klucza interfejsu API, prawdopodobnie 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. Możesz to zrobić, wybierając Nowy projekt z listy projektów lub klikając Utwórz projekt na stronie Menedżer zasobów.
2. Tworzenie nowego klucza interfejsu API Możesz to zrobić na stronie Dane logowania. Kliknij Utwórz dane logowania i wybierz Klucz interfejsu API.

Gdy znajdziesz projekt w Cloud Console, sprawdź, czy konto rozliczeniowe jest połączone, przechodząc do sekcji Płatności w menu po lewej stronie.

Nie, konto rozliczeniowe nie jest połączone z moim projektem.

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

Tak, z moim projektem jest połą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ść)?

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

Czy w interfejsie API został przekroczony dzienny limit?

Jeśli masz ustawiony dzienny limit któregoś z interfejsów API, co pozwala zapobiec nieoczekiwanym wzrostom, możesz go zwiększyć, zwiększając dzienny limit.

Dzienny limit czasu dostępu możesz sprawdzić w panelu interfejsów API i usług w Cloud Console. Tam:

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

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

Kluczy interfejsu API z ograniczeniem adresów IP można używać tylko w przypadku usług internetowych, które są przeznaczone do użytku po stronie serwera (takie jak interfejs API geokodowania i inne interfejsy API usług internetowych). Większość z tych usług internetowych ma swoje odpowiedniki w interfejsie Maps JavaScript API (np. usługa geokodowania). Aby korzystać z usług interfejsu API JavaScript Map Google, musisz utworzyć oddzielny klucz interfejsu API, który można zabezpieczyć za pomocą ograniczenia dotyczącego stron odsyłających 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 zwrócone przez interfejs API JavaScript Map Google wraz z opisem ich przyczyny i rozwiązaniem problemu. Informacje o tym, jak znaleźć komunikaty o błędach, znajdziesz w sekcji o sprawdzaniu błędów w przeglądarce.

Błędy wczytywania mapy

Jeśli podczas wczytywania interfejsu Maps JavaScript API pojawi się błąd, ich opisy znajdziesz w tabeli poniżej.

Kod błędu Wiadomość Opis

Kod błędu	Wiadomość	Opis
`NotLoadingAPIFromGoogleMapsError`	Interfejs Maps JavaScript API należy pobrać bezpośrednio z serwerów Google.	Element skryptu, który wczytuje interfejs Maps JavaScript API, nie jest poprawnie umieszczony na Twojej stronie. Aby interfejs API działał prawidłowo, musisz go wczytać bezpośrednio ze strony https://maps.googleapis.com. Zobacz Wczytywanie interfejsu Maps JavaScript API.
`TOSViolationMapError`	Wygląda na to, że ta witryna narusza Warunki korzystania z usługi interfejsu API Map Google. Interfejs API Map Google został wyłączony dla tej witryny.	Po otrzymaniu kilku powiadomień e-mail Twoja aplikacja została zablokowana z powodu nieprzestrzegania Warunków korzystania z usługi Google Maps Platform. Aby odwołać się od blokady i poprosić o sprawdzenie implementacji, wypełnij ten formularz. Otrzymasz e-maila z odpowiedzią w ciągu kilku dni roboczych. Jeśli masz licencję Premium na Google Maps Platform, możesz rozwiązać ten problem, korzystając z danych logowania abonamentu Google Maps Platform Premium. Zobacz przewodnik po uwierzytelnianiu abonamentu Premium.
`UnauthorizedURLForClientIdMapError`	Ten adres URL nie ma uprawnień do korzystania z podanego identyfikatora klienta Map Google.	Identyfikator klienta Premium lub Maps API for Work dołączony do skryptu jest nieprawidłowy lub wygasł albo bieżący adres podczas wczytywania interfejsu Maps JavaScript API nie został dodany do listy autoryzowanych adresów URL. Zobacz Rejestrowanie autoryzowanych adresów URL.

NotLoadingAPIFromGoogleMapsError

Interfejs Maps JavaScript API należy pobrać bezpośrednio z serwerów Google.

Element skryptu, który wczytuje interfejs Maps JavaScript API, nie jest poprawnie umieszczony na Twojej stronie. Aby interfejs API działał prawidłowo, musisz go wczytać bezpośrednio ze strony https://maps.googleapis.com.

Zobacz Wczytywanie interfejsu Maps JavaScript API.

TOSViolationMapError

Wygląda na to, że ta witryna narusza Warunki korzystania z usługi interfejsu API Map Google. Interfejs API Map Google został wyłączony dla tej witryny.

Po otrzymaniu kilku powiadomień e-mail Twoja aplikacja została zablokowana z powodu nieprzestrzegania Warunków korzystania z usługi Google Maps Platform. Aby odwołać się od blokady i poprosić o sprawdzenie implementacji, wypełnij ten formularz. Otrzymasz e-maila z odpowiedzią w ciągu kilku dni roboczych.

Jeśli masz licencję Premium na Google Maps Platform, możesz rozwiązać ten problem, korzystając z danych logowania abonamentu Google Maps Platform Premium. Zobacz przewodnik po uwierzytelnianiu abonamentu Premium.

UnauthorizedURLForClientIdMapError

Ten adres URL nie ma uprawnień do korzystania z podanego identyfikatora klienta Map Google.

Identyfikator klienta Premium lub Maps API for Work dołączony do skryptu jest nieprawidłowy lub wygasł albo bieżący adres podczas wczytywania interfejsu Maps JavaScript API nie został dodany do listy autoryzowanych adresów URL.

Zobacz Rejestrowanie autoryzowanych adresów URL.

Kody błędów interfejsu API JavaScript Map Google

Jeśli znajdziesz błąd w konsoli JavaScriptu Chrome, w konsoli internetowej Firefoksa lub innych odpowiednich narzędziach w przeglądarce, skorzystaj z opisów kodów błędów podanych w tabeli poniżej.

Interfejs Maps JavaScript API zwraca błędy i ostrzeżenia. Błąd oznacza poważny problem, który wystąpił podczas wczytywania interfejsu Maps JavaScript API. Twoja strona nie może prawidłowo wczytać interfejsu API i nie będzie na niej działać. Ostrzeżenie to dodatkowa wiadomość dotycząca wczytywania interfejsu Maps JavaScript API. Ostrzeżenie zawiera opis możliwych przyczyn błędów lub sugeruje potencjalne problemy z kodem, które wczytuje interfejs API JavaScript Map Google. 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 wszystkich potencjalnych problemów.

Kod błędu programisty	Typ	Opis
`ApiNotActivatedMapError`	Błąd	Interfejs Maps JavaScript API nie został aktywowany w Twoim projekcie API. Konieczne może być włączenie interfejsu Maps JavaScript API w sekcji interfejsów API w Google Cloud Console. Aby aktywować 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 tego interfejsu API. Sprawdź ustawienia ograniczenia interfejsu API klucza interfejsu API w Google Cloud Console, aby mieć pewność, ż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 Cloud Console. Więcej informacji znajdziesz w artykule Sprawdzone metody zabezpieczania interfejsu API.
`DeletedApiProjectMapError`	Błąd	Twój projekt API mógł zostać usunięty z Cloud Console. Sprawdź projekt, dla którego został wygenerowany klucz interfejsu API dołączony do programu wczytującego interfejs API JavaScript. Możesz utworzyć nowy projekt interfejsu API i uzyskać nowy klucz w Cloud Console. Aby utworzyć nowy projekt i uzyskać dla niego klucz 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, które powodują ten błąd. Musisz włączyć płatności w projekcie Google Cloud tutaj. Więcej informacji
`ExpiredKeyMapError`	Błąd	Klucz interfejsu API dołączony do elementu skryptu, który wczytuje interfejs API, wygasł lub nie został rozpoznany przez system. Ten błąd może się pojawić po utworzeniu nowego klucza interfejsu API, jeśli spróbujesz użyć tego klucza, zanim zostanie rozpoznany przez system. Zaczekaj kilka minut i spróbuj jeszcze raz. Może być konieczne wygenerowanie nowego klucza interfejsu API w Cloud Console. 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 poprawnie używasz swojego identyfikatora klienta. Identyfikator klienta powinien zaczynać się od „gme-”. Jeśli ten błąd pojawi się, mimo że poprawnie korzystasz ze swojego identyfikatora klienta, może to oznaczać, że wygasł. Skontaktuj się z menedżerem konta Google. Jeśli nie masz abonamentu Premium lub licencji na interfejsy API Map Google for Work, musisz użyć parametru `key` w kluczu interfejsu API zamiast parametru `client`. Zobacz przewodnik po uwierzytelnianiu abonamentu Premium.
`InvalidKeyMapError`	Błąd	Nie znaleziono klucza interfejsu API zawartego w elemencie skryptu, który wczytuje ten interfejs. Sprawdź, czy używasz prawidłowego klucza interfejsu API. Nowy klucz interfejsu API możesz wygenerować w Cloud Console. Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej. Rozpocznij
`MalformedCredentialsMapError`	Błąd	Twoja aplikacja korzysta z nieobsługiwanego schematu URI. Sprawdź, czy aplikacja używa prawidłowego formatu identyfikatora URI, zgodnie z definicją w RFC 3986.
`MissingKeyMapError`	Błąd	Element skryptu, który wczytuje interfejs API, nie ma wymaganego parametru uwierzytelniania. Jeśli używasz standardowego interfejsu API JavaScript Map Google, musisz używać 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 klientów. Jeśli NIE jesteś właścicielem witryny, nie musisz podejmować żadnych działań, aby poprawić 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 szczegółów błędu możesz znaleźć w Cloud Console. Zobacz Cloud Console.
`RefererDeniedMapError`	Błąd	Po otrzymaniu kilku powiadomień e-mail Twoja aplikacja została zablokowana z powodu nieprzestrzegania Warunków korzystania z usługi Google Maps Platform. Aby odwołać się od blokady i poprosić o sprawdzenie implementacji, wypełnij ten formularz. Otrzymasz e-maila z odpowiedzią 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 witryn odsyłających. Sprawdź ustawienia strony odsyłającej klucza interfejsu API w Cloud Console. Zobacz Maps JavaScript API i pobierz klucz API.
`OverQuotaMapError`	Błąd	Liczba żądań przekroczyła limity wykorzystania interfejsu Maps JavaScript API. Żądania aplikacji będą ponownie działać przy następnym zresetowaniu limitu dziennego. Jeśli NIE jesteś właścicielem witryny, nie możesz wykonać żadnych czynności, aby usunąć ten błąd. W miarę możliwości warto jednak powiadomić właściciela witryny. Więcej informacji znajdziesz w przewodniku po limitach wykorzystania. Na tej stronie wyjaśniamy też, jak możesz zwiększyć limity wykorzystania.
`ApiProjectMapError`	Błąd	Nie udało się rozwiązać 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ć, być może trzeba będzie uzyskać nowy klucz interfejsu API lub utworzyć nowy projekt interfejsu API. Więcej informacji znajdziesz w artykule Pierwsze kroki z Google Maps Platform.
`ClientIdLooksLikeCryptoKey`	Ostrzeżenie	Możliwe, że w parametrze `client` podano klucz kryptograficzny. Jeśli masz abonament Premium lub interfejsy API Map Google for Work, określ identyfikator klienta jako parametr `client`. W przypadku 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 for Work.
`ClientIdLooksLikeKey`	Ostrzeżenie	Być może podano klucz interfejsu API w parametrze `client`. Jeśli masz abonament Premium lub interfejsy API Map Google for Work, określ identyfikator klienta jako parametr `client`. Jeśli masz abonament Premium Google Maps Platform, możesz użyć parametru `client` lub `key`. Jeśli nie masz żadnych licencji, zamiast parametru `client` musisz użyć parametru `key`. Zobacz przewodnik po uwierzytelnianiu 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ć kropki (.), podkreślenia (_) i łączniki (-). Upewnij się, że określasz prawidłowy parametr `channel`. Zobacz Raportowanie \| Abonament Premium 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-”. Zobacz przewodnik po uwierzytelnianiu abonamentu Premium.
`InvalidKey`	Ostrzeżenie	Klucz interfejsu API zawarty w elemencie skryptu, który wczytuje ten interfejs API, wygląda na nieprawidłowy. Sprawdź, czy używasz prawidłowego klucza interfejsu API. Nowy klucz interfejsu API możesz wygenerować w Cloud Console. Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej. Rozpocznij
`InvalidVersion`	Ostrzeżenie	Być może w skrypcie skryptu podano nieprawidłowy numer wersji. Upewnij się, że używasz prawidłowego numeru wersji. Zobacz Obsługa wersji \| Interfejs API JavaScript Map Google.
`KeyLooksLikeClientId`	Ostrzeżenie	Być może podano identyfikator klienta jako parametr `key`. Jeśli masz licencję Premium lub Maps API for Work, określ identyfikator klienta jako parametr `client` zamiast parametru `key`. Jeśli masz abonament Premium Google Maps Platform, możesz użyć parametru `client` lub `key`. Jeśli nie masz żadnych licencji, zamiast parametru `client` musisz użyć parametru `key`. Zobacz przewodnik po uwierzytelnianiu abonamentu Premium.
`KeyLooksLikeCryptoKey`	Ostrzeżenie	Jako parametr `key` możesz dostarczyć klucz kryptograficzny lub tajny klucz podpisywania. Jeśli masz licencję Premium lub Maps API for Work, 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. Jeśli masz abonament Premium Google Maps Platform, możesz użyć parametru `client` lub `key`. Jeśli nie masz żadnych licencji, możesz uzyskać klucz interfejsu API w Cloud Console. Zapoznaj się z przewodnikiem Określanie identyfikatora klienta podczas wczytywania interfejsu API.
`KeyLooksLikeProjectNumber`	Ostrzeżenie	Być może podano numer projektu jako parametr `key`. Sprawdź, czy używasz prawidłowego klucza interfejsu API. Nowy klucz interfejsu API możesz wygenerować w Cloud Console. Dowiedz się, jak uzyskać klucz interfejsu API.
`NoApiKeys`	Ostrzeżenie	Element skryptu, który ładuje interfejs API, nie ma klucza interfejsu API. Pamiętaj, aby podać prawidłowy klucz interfejsu API jako parametr `key`. Nowy klucz interfejsu API możesz wygenerować w Cloud Console. Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej. Rozpocznij Jeśli wczytujesz interfejs Maps JavaScript API z wycofanej ścieżki v2, zobaczysz ostrzeżenie `NoApiKeys` nawet wtedy, gdy określisz parametr `key`. Zapoznaj się z przewodnikiem uaktualnienia do wersji 3, aby przenieść swoją aplikację do interfejsu Maps JavaScript API w wersji 3.
`RetiredVersion`	Ostrzeżenie	Możliwe, że w skrypcie skryptu podano wycofaną wersję. Zaktualizuj aplikację, aby używać jednej z dostępnych wersji. Zobacz Obsługa wersji \| Interfejs API JavaScript Map Google.
`SensorNotRequired`	Ostrzeżenie	Parametr `sensor` nie jest już wymagany dla interfejsu API JavaScript Map Google. Interfejs API JavaScript Map Google 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 ma to wpływu na prawidłowe działanie interfejsu Maps JavaScript API, ale może stanowić zagrożenie dla bezpieczeństwa. Usuń go z elementu skryptu.
`SignedInNotSupported`	Ostrzeżenie	Parametr `signed_in` został wycofany i nie jest obsługiwany w używanej wersji interfejsu Maps JavaScript API. Nie uniemożliwi to działania interfejsu Maps JavaScript API, ale działanie aplikacji może się zmienić, jeśli używasz funkcji zalogowanych użytkowników.
`UrlAuthenticationCommonError`	Błąd	Wystąpił błąd, który nie pasuje do innych kategorii na tej stronie. Może to być spowodowane tymczasowym problemem. Ponów żądanie po krótkim czasie. 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 witrynie window.console. Z tej sekcji dowiesz się, jak sprawdzić dane wyjściowe window.console w Google Chrome. Jeśli używasz innej przeglądarki, zapoznaj się z jej dokumentacją. Dla ułatwienia przedstawiamy listę narzędzi do sprawdzania danych wyjściowych window.console w niektórych innych przeglądarkach.

Web Console w przeglądarce Firefox.
Zdalne debugowanie na Androidzie.
Inspektora sieci Web na iOS.

W Chrome możesz skorzystać z 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ę JavaScriptu, naciśnij klawisz ESC na klawiaturze. Klawisz ESC będzie przełączać konsolę JavaScript. Jeśli zamkniesz konsolę, ponownie naciśnij klawisz ESC.

Jeśli podczas wczytywania interfejsu Maps JavaScript API wystąpią błędy lub ostrzeżenia, będą one widoczne 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]

W tabeli kodów błędów powyżej znajdziesz kod błędu. Możesz też znaleźć link do komunikatu o błędzie w dokumencie interfejsu API, do którego link znajdziesz w wiadomości.

Uwaga: możesz wykrywać błędy uwierzytelniania w sposób zautomatyzowany.

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ę systemu Windows, która działa w komponencie WebView, upewnij się, że używasz WebView2 na podstawie 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, Brendan Kenny i Mano Marks wskazują na typowe błędy i podpowiadają, jak je naprawić.

Sprawdź, czy nie ma literówek. Pamiętaj, że w języku JavaScript rozróżniana jest wielkość liter.
Sprawdź podstawowe zagadnienia – niektóre z najczęstszych problemów występują przy początkowym tworzeniu mapy. Przykłady:
- Sprawdź, czy w opcjach mapy zostały określone właściwości zoom i center.
- Upewnij się, że został zadeklarowany element div, w którym mapa pojawi się na ekranie.
- Upewnij się, że element div na mapie ma wysokość. Domyślnie elementy div są tworzone na wysokości 0 i dlatego są niewidoczne.
Zapoznaj się z naszymi przykładami dotyczącymi implementacji referencyjnej.
Aby zidentyfikować problemy, np. dostępne w Narzędziach Chrome dla programistów, użyj debugera JavaScriptu. Zacznij od znalezienia błędów w konsoli JavaScript.
Zadaj pytania na stronie Stack Overflow. Wskazówki dotyczące publikowania ciekawych pytań znajdziesz na stronie Pomoc.