Parametry adresu URL JavaScript API Map Google

W tym dokumencie omawiamy wszystkie parametry, które możesz określać w ciągu zapytania skryptu adresu URL wczytywania skryptu podczas wczytywania interfejsu Maps JavaScript API. Niektóre parametry są wymagane, a inne opcjonalne. Tak jak w przypadku standardu w adresach URL, wszystkie parametry są rozdzielone znakiem ampersand (&).

Ten przykładowy adres URL zawiera obiekty zastępcze dla wszystkich możliwych parametrów:

https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY
&callback=FUNCTION_NAME
&v=VERSION
&libraries="LIBRARIES"
&language="LANGUAGE"
&region="REGION"
&solution_channel="SOLUTION_IDENTIFIER"
&auth_referrer_policy="AUTH_REFERRER_POLICY"

Adres URL w tym przykładowym tagu script wczytuje interfejs Maps JavaScript API:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
</script>

Wymagane parametry

Poniższe parametry są wymagane podczas wczytywania interfejsu Maps JavaScript API.

  • key: klucz interfejsu API. Interfejs Maps JavaScript API nie zostanie załadowany, jeśli nie zostanie podany prawidłowy klucz interfejsu API.

  • callback: nazwa funkcji globalnej, która ma zostać wywołana po całkowitym wczytaniu interfejsu Maps JavaScript API.

Parametry opcjonalne

Używaj tych parametrów, aby zażądać określonej wersji interfejsu Maps JavaScript API, wczytać dodatkowe biblioteki, zlokalizować mapę lub określić zasadę sprawdzania stron odsyłających HTTP.

  • v: wersja interfejsu API JavaScript Map Google do użycia.

  • libraries: rozdzielona przecinkami lista dodatkowych bibliotek interfejsu Maps JavaScript API.

  • language: używany język. Ma to wpływ na nazwy elementów sterujących, informacji o prawach autorskich, wskazówek dojazdu i etykiet kontrolnych, a także na odpowiedzi na żądania usługi. Zobacz listę obsługiwanych języków.

  • region: kod regionu, którego należy użyć. Zmienia to działanie mapy w zależności od kraju lub terytorium.

  • solution_channel: Google Maps Platform udostępnia wiele typów przykładowego kodu, który ułatwia szybkie rozpoczęcie pracy. Aby śledzić wykorzystanie bardziej złożonych przykładów kodu i poprawić jakość rozwiązań, Google uwzględnia w przykładowym kodzie parametr zapytania solution_channel w wywołaniach interfejsu API.

  • auth_referrer_policy: klienci korzystający z tej usługi mogą konfigurować w Cloud Console ograniczenia dotyczące stron odsyłających HTTP, aby ograniczyć listę adresów URL, które mogą używać danego klucza interfejsu API. Domyślnie te ograniczenia mogą być skonfigurowane tak, aby klucz interfejsu API mógł być używany tylko w niektórych ścieżkach. Jeśli jakikolwiek adres URL w tej samej domenie lub źródle może używać klucza interfejsu API, możesz ustawić auth_referrer_policy=origin tak, by ograniczyć ilość danych wysyłanych podczas autoryzowania żądań z interfejsu Maps JavaScript API. Ta funkcja jest dostępna od wersji 3.46. Jeśli ten parametr jest określony, a w Cloud Console włączone są ograniczenia dotyczące stron odsyłających HTTP, interfejs Maps JavaScript API może wczytać się tylko wtedy, gdy istnieje ograniczenie stron odsyłających HTTP zgodne z domeną bieżącej witryny bez określonej ścieżki.