Na tej stronie opisujemy komunikaty o błędach, które mogą być zwracane przez Maps JavaScript API. Interfejs Maps JavaScript API zapisuje komunikatów o błędach i ostrzeżeniach. Określony błąd mogą również wystąpić warunki, które skutkują zaciemnieniem mapa ze znakiem wodnym.
Klucz interfejsu API i błędy rozliczeniowe
Rozwiązywanie problemów
W pewnych okolicznościach zaciemniona mapa lub wynik „negatywny” zdjęcie Street View ze znakiem wodnym z tekstem „tylko do celów programistycznych”, może być wyświetlana. Zwykle oznacza to problemy z kluczem interfejsu API lub płatnościami. Aby móc korzystać z usług Google Maps Platform, płatności muszą być włączone na koncie, a wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Informacje o znajdowaniu komunikatów o błędach znajdziesz w sekcji sprawdzanie błędów w przeglądarce.
Poniższy proces pomoże Ci rozwiązać ten problem.
Kody błędów interfejsu Maps JavaScript API dla programistów i właścicieli witryn
W tabelach poniżej znajdziesz możliwe kody błędów zwracanych przez Maps JavaScript API wraz z opisem przyczyny i możliwości rozwiązań problemu. Pomoc w znalezieniu komunikatów o błędach znajdziesz w sekcji sprawdzanie błędów w przeglądarce.
Błędy wczytywania mapy
Jeśli podczas wczytywania interfejsu Maps JavaScript API wystąpi błąd, Wyjaśnienia kodów błędów znajdziesz w tabeli poniżej.
Kod błędu | Wiadomość | Opis |
---|---|---|
NotLoadingAPIFromGoogleMapsError
|
Interfejs Maps JavaScript API należy pobrać bezpośrednio z serwerów. |
Elementem skryptu, który wczytuje interfejs Maps JavaScript API, jest nie są poprawnie uwzględnione na stronie. Aby interfejs API mógł działać musi być wczytywany bezpośrednio z https://maps.googleapis.com. Zobacz Wczytuję 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: Warunki korzystania z usługi Google Maps Platform po kilku e-mailach z powiadomieniami. Aby odwołać się od decyzji zablokuj i poproś o sprawdzenie implementacji, dokończ ten formularz. Odpowiedź otrzymasz e-mailem w ciągu kilku dni roboczych. Jeśli masz licencję na Google Maps Platform Premium, użyj Dane logowania w wersji premium Google Maps Platform do naprawienia tego błędu. Zobacz przewodnik Uwierzytelnianie w ramach abonamentu Premium. |
UnauthorizedURLForClientIdMapError
|
Ten URL nie ma uprawnień do korzystania z podanego identyfikatora klienta Map Google. |
abonament Premium lub Maps API for Work, identyfikator klienta zawarty w wczytywaniu skryptu jest nieprawidłowy, wygasła lub bieżący adres wczytuje do Interfejs Maps JavaScript API nie został dodany do listy autoryzowane URL-e. |
Kody błędów Maps JavaScript API
Jeśli znajdziesz błąd w przeglądarce Chrome JavaScript Konsola, Firefox konsola internetowa lub podobne narzędzia w przeglądarce, Wyjaśnienia kodów błędów znajdziesz w tabeli poniżej.
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 Maps JavaScript API. Strona nie może poprawnie wczytać interfejsu API, a interfejs API nie będzie działać na tej stronie. Ostrzeżenie to dodatkowy komunikat o wczytaniu Maps JavaScript API. W ostrzeżeniem podano możliwe przyczyny pod kątem błędu lub sugerują 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ć. na tej stronie. Zalecamy jednak naprawienie tych .
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 w konsoli Google Cloud. Aby aktywować Maps JavaScript API w swoim projekcie, kliknij przycisk poniżej.
|
ApiTargetBlockedMapError
|
Błąd |
Ten klucz interfejsu API nie ma uprawnień do korzystania z tej usługi lub interfejsu API. Sprawdź ustawienia ograniczeń interfejsów API swojego klucza interfejsu API w Google Cloud Console, dzięki któremu możesz mieć pewność, że wszystkie interfejsy API i usługi, których potrzebujesz, których chcesz używać, są prawidłowo określone na liście włączonych interfejsów API. Zobacz kluczy interfejsów API w Cloud Console. Więcej informacji: Sprawdzone metody zabezpieczania interfejsów 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 zawarte w programie wczytującym JavaScript API. Możesz utworzyć nowy projekt API pobierz nowy klucz w konsoli Cloud. Aby utworzyć nowy projekt i uzyskać dla niego klucz interfejsu API, kliknij przycisk poniżej.
|
ClientBillingNotEnabledMapError
|
Błąd |
Nie masz włączonych płatności w projekcie. Musisz włączyć Rozliczenia w Google Cloud Projekt powiązany z tym identyfikatorem klienta, tutaj. |
BillingNotEnabledMapError
|
Błąd |
W projekcie nie włączono płatności, co jest przyczyną tego błędu. Musisz włączyć Płatności w projekcie Google Cloud tutaj. |
ExpiredKeyMapError
|
Błąd |
Klucz interfejsu API zawarty w elemencie skryptu, który wczytuje interfejs API, ma wygasła lub nie została rozpoznana przez system. Ten błąd może się pojawić po utworzeniu nowego klucza interfejsu API, jeśli spróbujesz go użyć, zanim zostanie rozpoznany przez system. Zaczekaj chwilę i spróbuj ponownie. Może być też konieczne wygenerowanie nowego klucza interfejsu API Konsola Cloud. Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej.
|
InvalidClientIdMapError
|
Błąd |
Identyfikator klienta zawarty w elemencie skryptu, który wczytuje interfejs API, to jest nieprawidłowy lub stracił ważność. Upewnij się, że używasz identyfikatora klienta . Identyfikator klienta powinien zaczynać się od „gme-” . Jeśli zobaczysz komunikat ten błąd, nawet jeśli używasz poprawnie identyfikatora klienta, może on straciły ważność. Skontaktuj się ze swoim opiekunem klienta w Google.
Jeśli nie masz abonamentu Premium lub
Maps APIs for Work, musisz używać
Zobacz przewodnik Uwierzytelnianie w ramach abonamentu Premium. |
InvalidKeyMapError
|
Błąd |
Klucz interfejsu API zawarty w elemencie skryptu, który wczytuje interfejs API, nie jest . Upewnij się, że używasz prawidłowego klucza interfejsu API. Dostępne opcje wygenerować nowy klucz interfejsu API w konsoli Cloud. Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej.
|
MalformedCredentialsMapError
|
Błąd |
Aplikacja używa nieobsługiwanego schematu identyfikatora URI. Sprawdź, czy aplikacja używa prawidłowy format identyfikatora URI zgodny z definicją w dokumencie RFC 3986. |
MissingKeyMapError
|
Błąd |
W elemencie skryptu, który wczytuje interfejs API, brakuje wymaganego parametru uwierzytelniania. Jeśli używasz standardowego interfejsu Maps JavaScript API, użyj
parametr Jeśli masz abonament Premium,
użyj parametru Jeśli NIE jesteś właścicielem witryny, nie możesz rozwiązać tego problemu . Warto jednak powiadomić o tym właściciela witryny, jeśli będzie to możliwe. |
ProjectDeniedMapError
|
Błąd |
Twoja prośba nie została zrealizowana. Możesz znaleźć więcej o błędzie w konsoli Google Cloud. Zobacz konsolę Cloud. |
RefererDeniedMapError
|
Błąd |
Twoja aplikacja została zablokowana z powodu niezgodności z: Warunki korzystania z usługi Google Maps Platform po kilku e-mailach z powiadomieniami. Aby odwołać się od decyzji zablokuj i poproś o sprawdzenie implementacji, dokończ ten formularz. Odpowiedź otrzymasz e-mailem w ciągu kilku dni roboczych. |
RefererNotAllowedMapError
|
Błąd |
Obecny adres URL, który wczytuje interfejs Maps JavaScript API, nie został została dodana do listy dozwolonych stron odsyłających. Sprawdź stronę odsyłającą klucza interfejsu API w konsoli Cloud. Zapoznaj się z interfejsem Maps JavaScript API oraz Uzyskaj klucz interfejsu API. |
OverQuotaMapError
|
Błąd |
Liczba żądań przekroczyła limity wykorzystania dla Maps JavaScript API. Prośby z aplikacji znów będą działać przy następnym zresetowaniu limitu dziennego. Jeśli NIE jesteś właścicielem witryny, nie musisz nic robić, napraw ten błąd. Warto jednak powiadomić o tym właściciela witryny, jeśli będzie to możliwe. Więcej informacji znajdziesz w przewodniku limity wykorzystania. Na stronie znajdziesz też informacje o tym, jak podnieść limity wykorzystania. |
ApiProjectMapError
|
Błąd |
Podany klucz interfejsu API lub projekt interfejsu API, z którym jest powiązany, nie udało się rozwiązać. Ten błąd może być tymczasowy. Jeśli ten komunikat o błędzie może być konieczne uzyskanie nowego klucza interfejsu API lub utworzenie nowego projektu API. Więcej informacji: Pierwsze kroki z Google Maps Platform |
ClientIdLooksLikeCryptoKey
|
Ostrzeżenie |
Możliwe, że Zobacz przewodnik klient identyfikatory wersji Premium oraz Klienci Google Maps API for Work. |
ClientIdLooksLikeKey
|
Ostrzeżenie |
Możliwe, że w parametrze Zobacz przewodnik Uwierzytelnianie w ramach abonamentu Premium. |
InvalidChannel
|
Ostrzeżenie |
Możliwe, że podano nieprawidłowy parametr Zobacz Raportowanie | Google Maps Platform w wersji premium. |
InvalidClientId
|
Ostrzeżenie |
Wygląda na to, że parametr Zobacz przewodnik Uwierzytelnianie w ramach abonamentu Premium. |
InvalidKey
|
Ostrzeżenie |
Klucz interfejsu API umieszczony w elemencie skryptu, który wczytuje interfejs API, nie wyglądają dobrze. 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.
|
InvalidVersion
|
Ostrzeżenie |
Możliwe, że w elemencie skryptu podano nieprawidłowy numer wersji. Upewnij się, że używasz prawidłowego numeru wersji. |
KeyLooksLikeClientId
|
Ostrzeżenie |
Możliwe, że jako parametr key został podany identyfikator klienta. Jeśli
masz abonament Premium lub
Licencja Maps APIs for Work. Podaj swój identyfikator klienta jako
client zamiast parametru key . Jeśli posiadasz
w wersji premium na Google Maps Platform, możesz używać parametru client .
lub parametr key . Jeśli nie masz żadnych licencji,
musisz użyć parametru key zamiast parametru client
.
Zobacz przewodnik Uwierzytelnianie w ramach abonamentu Premium. |
KeyLooksLikeCryptoKey
|
Ostrzeżenie |
Możliwe, że otrzymaliśmy od Ciebie klucz kryptograficzny lub tajny klucz podpisywania jako Zobacz przewodnik Określanie identyfikatora klienta podczas wczytywania interfejsu API. |
KeyLooksLikeProjectNumber
|
Ostrzeżenie |
Możliwe, że jako parametr Dowiedz się, jak uzyskać klucz interfejsu API. |
NoApiKeys
|
Ostrzeżenie |
Element skryptu, który wczytuje interfejs API, nie ma klucza interfejsu API. Sprawdź, czy
podasz prawidłowy klucz interfejsu API jako parametr
Jeśli chcesz uzyskać klucz interfejsu API, kliknij przycisk poniżej.
Jeśli wczytujesz Maps JavaScript API z wycofanej wersji 2
ścieżki, otrzymasz ostrzeżenie |
RetiredVersion
|
Ostrzeżenie |
Możliwe, że w elemencie skryptu znajdują się wycofane wersje. Zaktualizuj aplikację tak, aby używała jednej z dostępnych wersji. |
SensorNotRequired
|
Ostrzeżenie |
Parametr |
SignatureNotRequired
|
Ostrzeżenie |
Parametr |
SignedInNotSupported
|
Ostrzeżenie |
Parametr |
UrlAuthenticationCommonError
|
Błąd |
Wystąpił błąd, który nie pasuje do innych kategorii w tej stronę. Może to być spowodowane tymczasowym problemem. Ponów próbę po krótkim opóźnieniu. Jeśli to nie rozwiąże problemu, zapoznaj się z przewodnik dla programistów aby sprawdzić, czy żądanie ma właściwy format. |
Sprawdzanie błędów w przeglądarce
Interfejs Maps JavaScript API zapisuje komunikaty o błędach w
window.console
W tej sekcji wyjaśniamy, jak sprawdzić
Dane wyjściowe window.console
w Google Chrome. Jeśli używasz innego
zapoznaj się z dokumentacją dla deweloperów dotyczącą danej przeglądarki. Na
to lista narzędzi do sprawdzenia danych wyjściowych z narzędzia window.console
w niektórych innych przeglądarkach.
- Konsola sieciowa w przeglądarce Firefox.
- Zdalne debugowanie na Androida.
- Inspektora sieci na iOS.
W Chrome możesz użyć funkcji
Konsola JavaScript
aby sprawdzić dane wyjściowe funkcji window.console
w następujący 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. Klawisz ESC przełącza między konsolą JavaScriptu. Jeśli zamkniesz konsolę, naciśnij ponownie klawisz ESC, aby go otworzyć.
Jeśli podczas wczytywania Maps JavaScript API, są widoczne jako co najmniej jeden wiersz w konsoli. 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 informacje kod błędu w komunikacie o błędzie. Znajdziesz tam też informacje na temat w dokumencie API, do którego link znajduje się w wiadomości.
Uwaga: możesz nasłuchiwanie błędów uwierzytelniania automatycznie.
Obsługa nieobsługiwanych przeglądarek
Upewnij się, że używana przez Ciebie wersja przeglądarki to obecnie obsługiwane przez Maps JavaScript API.
Jeśli tworzysz natywną aplikację dla systemu Windows, która działa w komponencie WebView, korzysta z opartego na WebView2, w 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 na mapie, Brendan Kenny i Mano Marks wskazują o najczęstszych błędach i sposobach ich naprawy.
- Sprawdź, czy nie ma literówek. Pamiętaj, że w JavaScripcie wielkość liter ma znaczenie język.
- Sprawdź podstawy – niektóre z najczęstszych problemów dotyczą
przy tworzeniu mapy. Na przykład:
- Potwierdź, że w polu
zoom
została określona wartość icenter
miejsca zakwaterowania na Twojej mapie . - Upewnij się, że został zadeklarowany element div, w którym mapa widoczne na ekranie.
- Upewnij się, że element div mapy ma wysokość. Domyślnie Elementy div są tworzone o wysokości 0, dlatego są niewidoczny.
- Potwierdź, że w polu
- Użyj debugera JavaScriptu, aby zidentyfikować problemy, takie jak ten, który może być dostępny W przeglądarce Chrome Narzędzia dla programistów. Zacznij od wyszukania błędów w konsoli JavaScript.
- Publikuj pytania w Stosie Rozwiń menu. Wskazówki na temat publikowania świetnych pytań są dostępne na stronę Pomoc.