Uzyskaj klucz demonstracyjny Map: wypróbuj bezpłatnie wybrane funkcje Maps JavaScript API i Places UI Kit, korzystając z klucza demonstracyjnego Map – nie musisz podawać informacji rozliczeniowych.

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.

Rozwiązywanie problemów

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

W pewnych okolicznościach może wyświetlać się przyciemniona mapa lub „negatyw” zdjęcia Street View ze znakiem wodnym „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 rozwiązać ten problem, wykonaj te czynności:

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ą interfejsu 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, do której możesz przejść z paska bocznego po lewej stronie, klikając 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 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.

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).

Jeśli kod 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 bezpośrednio określoną niezerową wysokość CSS (np. height: 400px). 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 takich jak InvalidKeyMapError lub ApiNotActivatedMapError. Aby je rozwiązać, zapoznaj się z przewodnikiem po komunikatach o błędach.
Zadawaj pytania na Stack Overflow. Wskazówki dotyczące publikowania dobrych pytań znajdziesz na stronie Pomoc.