Параметры URL-адреса JavaScript API Карт

В этом документе обсуждаются все параметры, которые можно указать в строке запроса URL-адреса загрузки скрипта при загрузке Maps JavaScript API . Некоторые параметры являются обязательными, а другие необязательными. Как это принято в URL-адресах, все параметры разделяются с помощью символа амперсанда ( & ).

В следующем примере URL-адреса есть заполнители для всех возможных параметров:

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"

URL-адрес в следующем примере script загружает Maps JavaScript API:

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

Обязательные параметры

Следующие параметры необходимы при загрузке Maps JavaScript API.

  • key : ваш ключ API . Maps JavaScript API не будет загружаться, пока не будет указан действительный ключ API.

  • callback : имя глобальной функции, которая будет вызываться после полной загрузки Maps JavaScript API.

Дополнительные параметры

Используйте эти параметры, чтобы запросить конкретную версию Maps JavaScript API, загрузить дополнительные библиотеки, локализовать карту или указать политику проверки реферера HTTP.

  • v : используемая версия Maps JavaScript API.

  • libraries : разделенный запятыми список дополнительных библиотек Maps JavaScript API для загрузки.

  • language : язык для использования. Это влияет на названия элементов управления, уведомления об авторских правах, направления движения и метки элементов управления, а также на ответы на запросы на обслуживание. См. список поддерживаемых языков .

  • region : код региона для использования. Это изменяет поведение карты в зависимости от данной страны или территории.

  • solution_channel : Платформа Google Карт предоставляет множество типов примеров кода, которые помогут вам быстро приступить к работе. Чтобы отслеживать внедрение наших более сложных примеров кода и повышать качество решений, Google включает параметр запроса solution_channel в вызовы API в нашем примере кода.

  • auth_referrer_policy : клиенты Maps JS могут настроить ограничения реферера HTTP в облачной консоли, чтобы ограничить URL-адреса, которым разрешено использовать определенный ключ API. По умолчанию эти ограничения можно настроить так, чтобы только определенные пути могли использовать API-ключ. Если какой-либо URL-адрес в том же домене или источнике может использовать ключ API, вы можете установить auth_referrer_policy=origin , чтобы ограничить объем данных, отправляемых при авторизации запросов от Maps JavaScript API. Это доступно, начиная с версии 3.46. Если указан этот параметр и в Cloud Console включены ограничения HTTP-реферера, Maps JavaScript API сможет загружаться только при наличии ограничения HTTP-реферера, которое соответствует домену текущего веб-сайта без указания пути.