Ogłoszenie: wkrótce w Google Maps Platform pojawi się nowy styl mapy podstawowej. Ta aktualizacja stylizacji mapy obejmuje nową domyślną paletę kolorów, ulepszone piny oraz udoskonalenia dotyczące obsługi i użyteczności map. Wszystkie style map zostaną automatycznie zaktualizowane w marcu 2025 r. Więcej informacji o dostępności i o tym, jak wcześniej włączyć tę funkcję, znajdziesz w artykule Nowy styl map w Google Maps Platform.

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

Rozwiązywanie problemów

Klucz interfejsu API i błędy rozliczeniowe

W pewnych okolicznościach może zostać wyświetlona przyciemniona mapa lub „negatywowy” obraz Street View z znakami wodnymi z tekstem „for development purposes only” (tylko do celów rozwojowych). Takie zachowanie zwykle wskazuje na problemy z kluczem API lub rozliczeniami. Aby korzystać z usług Google Maps Platform, musisz mieć na koncie włączone płatności, a wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Aby rozwiązać ten problem:

Czy używasz klucza interfejsu API?

Tego nie wiem. Jak sprawdzić, czy używam klucza interfejsu API?

Klucz interfejsu API jest przekazywany jako parametr key w adresie URL służącym do wczytania interfejsu Maps JavaScript API. Oto kilka sposobów sprawdzania, czy używasz klucza API:

Użyj rozszerzenia do przeglądarki 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 wczytania 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 prawidłowo klucza interfejsu API:

Ostrzeżenie interfejsu Maps JavaScript API: NoApiKeys
Błąd interfejsu 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 w poniżej zamieszczonym kodzie wartość YOUR_API_KEY swoim kluczem interfejsu API.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Sprawdź w przeglądarce ruch sieciowy generowany przez Twoją witrynę. W Chrome można to sprawdzić na karcie DevTools Sieć. Tutaj zobaczysz żądania sieci wysyłane przez Twoją witrynę. Żądania wysyłane za pomocą interfejsu Maps JavaScript API będą znajdować się na ścieżce maps/api/js. Tutaj możesz sprawdzić, czy żądania używają parametru key. Gdy wyświetlasz kartę Sieć, możesz filtrować ruch sieciowy 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 przewodnika konfiguracji, postępuj zgodnie z pełnymi instrukcjami w artykule Pierwsze kroki z Google Maps Platform.
Pierwsze kroki

Tak, używam klucza interfejsu API.

Świetnie. Sprawdźmy, czy z projektem jest połączone konto rozliczeniowe.

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

Tego nie wiem. Jak sprawdzić, czy konto rozliczeniowe jest połączone z moim projektem?

Otwórz stronę Płatności w konsoli Google Cloud i wybierz projekt, w którym utworzono Twój klucz interfejsu API. Aby sprawdzić, czy klucz jest powiązany z projektem:

Otwórz sekcję Dane logowania, do której możesz przejść z poziomego paska po lewej stronie w sekcji Google Maps Platform > Dane logowania.
Sprawdź, czy na liście znajduje się klucz interfejsu API, którego obecnie używasz w witrynie. Jeśli tak nie jest, przejdź do innego projektu i sprawdź tam te dane.
Jeśli nie możesz znaleźć projektu ze swoim kluczem interfejsu API, być może nie masz dostępu do tego projektu. Poproś o pomoc innych użytkowników w organizacji. Jeśli nie można znaleźć oryginalnego projektu, wykonaj te czynności:
1. Utwórz nowy projekt. Aby to zrobić, wybierz Nowy projekt na liście projektów lub kliknij Utwórz projekt na stronie Menedżera zasobów.
2. Tworzenie nowego klucza interfejsu API Możesz to zrobić na stronie Dane logowania. Następnie kliknij kolejno Utwórz dane logowania i Klucz interfejsu API.

Po znalezieniu projektu w Cloud Console sprawdź, czy jest do niego dołączone konto rozliczeniowe. Aby to zrobić, otwórz sekcję Płatności w menu po lewej stronie.

Nie, mojego projektu nie powiązano z kontem rozliczeniowym.

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

Tak, do mojego projektu jest przypisane konto rozliczeniowe.

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

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

możesz dodawać, usuwać i aktualizować formę płatności w Konsoli Cloud.

Czy został przekroczony samookreślony dzienny limit interfejsu API?

Jeśli dla któregoś z interfejsów API ustawiony jest limit dzienny, 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 interfejsów API i usług w konsoli Cloud. Gdy otworzysz Menedżera:

Jeśli pojawi się monit, wybierz projekt.
Wybierz interfejs API z listy, a potem 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 przeznaczonych do użytku po stronie serwera (np. Geocoding API i innych interfejsów API usług sieciowych). Większość tych usług internetowych 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 stron odsyłających HTTP (patrz Uzyskiwanie, dodawanie i ograniczanie dostępu do 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.

Sprawdź, czy nie ma literówek. Pamiętaj, że w JavaScript wielkość liter ma znaczenie.
Sprawdź podstawy – niektóre z najczęstszych problemów występują podczas początkowego tworzenia mapy. Na przykład:
- Sprawdź, czy w opcjach mapy masz określone właściwości zoom i center.
- Upewnij się, że masz zadeklarowany element div, w którym mapa będzie widoczna na ekranie.
- Upewnij się, że element div mapy ma wysokość. Domyślnie elementy div są tworzone z wysokością 0, dzięki czemu są niewidoczne.
Zapoznaj się z naszych przykładami, aby zobaczyć, jak wygląda implementacja referencyjna.
W identyfikacji problemów, np. w Narzędziach deweloperskich w Chrome, możesz użyć debugera JavaScriptu. Zacznij od wyszukania błędów w konsoli JavaScript.
Opublikuj pytania na Stack Overflow. Wskazówki, jak publikować dobre pytania, znajdziesz na stronie Pomoc.