Встроить карту

В этом руководстве показано, как встроить интерактивную карту на вашу веб-страницу.

Создайте URL-адрес API для встраивания карт.

Ниже приведён пример URL-адреса, загружающего API для встраивания карт:

https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS

Заменять:

Вставьте URL-адрес в iframe.

Чтобы использовать API встраивания карт на вашей веб-странице, укажите созданный вами URL-адрес в качестве значения атрибута src элемента iframe. Размер карты можно регулировать с помощью атрибутов height и width элемента iframe, например:

<iframe
  width="450"
  height="250"
  frameborder="0" style="border:0"
  referrerpolicy="strict-origin-when-cross-origin"
  src="https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS"
  allowfullscreen>
</iframe>

В приведенном выше примере iframe используются дополнительные свойства:

  • Свойство allowfullscreen позволяет отображать определенные части карты на весь экран.
  • Свойства frameborder="0" и style="border:0" позволяют удалить стандартную рамку iframe вокруг карты.
  • Свойство referrerpolicy="strict-origin-when-cross-origin" гарантирует, что браузер отправляет домен вашего веб-сайта в качестве заголовка Referer в Google. Это позволяет использовать ограничения по ключу API для проверки запроса, сохраняя при этом конфиденциальность конкретных путей к страницам.

Вы можете изменить размер iframe в соответствии со структурой и дизайном вашего веб-сайта, но мы заметили, что посетителям обычно удобнее взаимодействовать с картами большего размера. Обратите внимание, что встроенные карты не поддерживаются размером менее 200 пикселей ни по одному из параметров.

Ограничения, связанные с информацией о реферере и ключом API.

Если в метатеге referrer веб-сайта установлено значение no-referrer или same-origin , браузер не будет отправлять заголовок Referer в Google. Это может привести к тому, что ограничение по ключу API отклонит запросы. Для корректной работы ограничения добавьте свойство referrerpolicy к iframe, как в примере выше, чтобы явно разрешить отправку заголовков Referer в Google.

  • strict-origin-when-cross-origin (Рекомендуется): Отправляет в Google только ваш базовый домен (например, https://example.com/). Это обеспечивает конфиденциальность путей к вашим страницам, при этом сохраняя возможность использования ограничений по ключу API.
  • no-referrer-when-downgrade (Legacy): Отправляет весь URL-адрес, включая конкретные пути к страницам и параметры запроса (например, https://example.com/contact?user=123).

Узнайте больше о заголовке Referrer-Policy .

Выберите режимы карты

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

  • place : отображает на карте метку в определенном месте или по определенному адресу, например, в качестве ориентира, названия предприятия, географического объекта или названия города.
  • view : возвращает карту без маркеров и указаний.
  • directions отображает маршрут между двумя или более указанными точками на карте, а также расстояние и время в пути.
  • streetview : отображает интерактивные панорамные виды из указанных мест.
  • search : отображает результаты поиска по видимой области карты.

режим place

Следующая ссылка использует режим отображения place для показа маркера на карте, расположенного рядом с Эйфелевой башней:

https://www.google.com/maps/embed/v1/place
  ?key=YOUR_API_KEY
  &q=Eiffel+Tower,Paris+France

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

Параметр Тип Описание Принятые значения
q Необходимый Определяет местоположение маркера на карте. Название места, адрес, код или идентификатор места экранируются в URL-адресе. API встраивания карт поддерживает как + , так и %20 при экранировании пробелов. Например, преобразуйте "City Hall, New York, NY" в City+Hall,New+York,NY , или коды "849VCWC8+R9" в 849VCWC8%2BR9 .
center Необязательный Определяет центр отображения карты. Принимает значения широты и долготы, разделенные запятыми; например: 37.4218,-122.0840 .
zoom Необязательный Устанавливает начальный уровень масштабирования карты. Значения варьируются от 0 (весь мир) до 21 (отдельные здания). Верхний предел может меняться в зависимости от доступных картографических данных в выбранном местоположении.
maptype Необязательный Определяет тип загружаемых фрагментов карты. roadmap (по умолчанию) или satellite
language Необязательный Определяет язык, используемый для элементов пользовательского интерфейса и для отображения подписей на фрагментах карты. По умолчанию посетители будут видеть карту на своем родном языке. Этот параметр поддерживается только для некоторых фрагментов карты стран; если запрошенный язык не поддерживается для данного набора фрагментов, будет использоваться язык по умолчанию для этого набора фрагментов.
region Необязательный Определяет соответствующие границы и метки для отображения с учетом геополитической специфики. Принимает код региона, заданный в виде двухсимвольного (нечислового) субтега региона Unicode, соответствующего распространенным двухсимвольным значениям ccTLD («домен верхнего уровня»). См. подробную информацию о поддерживаемых регионах в разделе «Подробности покрытия платформы Google Maps» .

режим view

В следующем примере для отображения спутникового вида карты используются режим view и необязательный параметр maptype :

https://www.google.com/maps/embed/v1/view
  ?key=YOUR_API_KEY
  &center=-33.8569,151.2152
  &zoom=18
  &maptype=satellite

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

Параметр Тип Описание Принятые значения
center Необходимый Определяет центр отображения карты. Принимает значения широты и долготы, разделенные запятыми; например: 37.4218,-122.0840 .
zoom Необязательный Устанавливает начальный уровень масштабирования карты. Значения варьируются от 0 (весь мир) до 21 (отдельные здания). Верхний предел может меняться в зависимости от доступных картографических данных в выбранном местоположении.
maptype Необязательный Определяет тип загружаемых фрагментов карты. roadmap (по умолчанию) или satellite
language Необязательный Определяет язык, используемый для элементов пользовательского интерфейса и для отображения подписей на фрагментах карты. По умолчанию посетители будут видеть карту на своем родном языке. Этот параметр поддерживается только для некоторых фрагментов карты стран; если запрошенный язык не поддерживается для данного набора фрагментов, будет использоваться язык по умолчанию для этого набора фрагментов.
region Необязательный Определяет соответствующие границы и метки для отображения с учетом геополитической специфики. Принимает код региона, заданный в виде двухсимвольного (нечислового) субтега региона Unicode, соответствующего распространенным двухсимвольным значениям ccTLD («домен верхнего уровня»). См. подробную информацию о поддерживаемых регионах в разделе «Подробности покрытия платформы Google Maps» .

режим directions

В следующем примере используется режим directions для отображения пути между Ословом и Телемарком (Норвегия), расстояния и времени в пути, без учета платных дорог и автомагистралей.

https://www.google.com/maps/embed/v1/directions
  ?key=YOUR_API_KEY
  &origin=Oslo+Norway
  &destination=Telemark+Norway
  &avoid=tolls|highways

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

Параметр Тип Описание Принятые значения
origin Необходимый Определяет начальную точку, от которой будет отображаться маршрут. Название места, адрес, код, координаты широты/долготы или идентификатор места экранируются в URL-адресе. API встраивания карт поддерживает как + , так и %20 при экранировании пробелов. Например, преобразуйте "City Hall, New York, NY" в City+Hall,New+York,NY , или коды "849VCWC8+R9" в 849VCWC8%2BR9 .
destination Необходимый Определяет конечную точку направлений. Название места, адрес, код, координаты широты/долготы или идентификатор места экранируются в URL-адресе. API встраивания карт поддерживает как + , так и %20 при экранировании пробелов. Например, преобразуйте "City Hall, New York, NY" в City+Hall,New+York,NY , или коды "849VCWC8+R9" в 849VCWC8%2BR9 .
waypoints Необязательный Указывает одно или несколько промежуточных мест для прокладки маршрута между пунктом отправления и пунктом назначения. Название места, адрес или идентификатор места . Можно указать несколько путевых точек, разделяя их символом вертикальной черты (|) (например Berlin,Germany|Paris,France ). Можно указать до 20 путевых точек.
mode Необязательный Определяет способ передвижения. Если способ передвижения не указан, API Maps Embed отобразит один или несколько наиболее подходящих способов передвижения для указанного маршрута. driving , walking (предпочтительно по пешеходным дорожкам и тротуарам, где это возможно), bicycling (предпочтительно по маршрутам с велосипедными дорожками и улицами, где это возможно), transit или flying .
avoid Необязательный Указывает на особенности местности, которых следует избегать в маршруте. Обратите внимание, что это не исключает маршруты, включающие указанные особенности; это смещает результат в сторону более благоприятных маршрутов. tolls , ferries и/или highways . Разделяйте несколько значений символом вертикальной черты (например avoid=tolls|highways ).
units Необязательный Указывает метод измерения (метрический или имперский) при отображении расстояний в результатах. Если units не указаны, используемые единицы определяются страной origin запроса. metric или imperial мер
center Необязательный Определяет центр отображения карты. Принимает значения широты и долготы, разделенные запятыми; например: 37.4218,-122.0840 .
zoom Необязательный Устанавливает начальный уровень масштабирования карты. Значения варьируются от 0 (весь мир) до 21 (отдельные здания). Верхний предел может меняться в зависимости от доступных картографических данных в выбранном местоположении.
maptype Необязательный Определяет тип загружаемых фрагментов карты. roadmap (по умолчанию) или satellite
language Необязательный Определяет язык, используемый для элементов пользовательского интерфейса и для отображения подписей на фрагментах карты. По умолчанию посетители будут видеть карту на своем родном языке. Этот параметр поддерживается только для некоторых фрагментов карты стран; если запрошенный язык не поддерживается для данного набора фрагментов, будет использоваться язык по умолчанию для этого набора фрагментов.
region Необязательный Определяет соответствующие границы и метки для отображения с учетом геополитической специфики. Принимает код региона, заданный в виде двухсимвольного (нечислового) субтега региона Unicode, соответствующего распространенным двухсимвольным значениям ccTLD («домен верхнего уровня»). См. подробную информацию о поддерживаемых регионах в разделе «Подробности покрытия платформы Google Maps» .

режим streetview

API Maps Embed позволяет отображать изображения Street View в виде интерактивных панорам из заданных мест по всей зоне покрытия . Также доступны добавленные пользователями фотосферы и специальные коллекции Street View .

Каждая панорама Street View обеспечивает полный 360-градусный обзор из одной точки. Изображения содержат 360 градусов горизонтального обзора (полный круговой обзор) и 180 градусов вертикального обзора (от вертикального положения вверх до вертикального положения вниз). В режиме streetview окно просмотра отображает полученную панораму в виде сферы с камерой в центре. Вы можете управлять камерой, чтобы регулировать масштаб и ориентацию камеры.

Посмотрите на следующую панораму в режиме streetview :

https://www.google.com/maps/embed/v1/streetview
  ?key=YOUR_API_KEY
  &location=46.414382,10.013988
  &heading=210
  &pitch=10
  &fov=35

Для корректной работы требуется один из следующих параметров URL:

  • location принимает широту и долготу в виде значений, разделенных запятыми ( 46.414382,10.013988 10.013988). API отображает панораму, снятую ближе всего к этому местоположению. Поскольку изображения Street View периодически обновляются, и фотографии могут быть сделаны с немного разных позиций каждый раз, возможно, что при обновлении изображений ваше местоположение может автоматически переключиться на другую панораму.

  • pano — это конкретный идентификатор панорамы. Если вы указываете pano вы также можете указать location . location используется только в том случае, если API не может найти идентификатор панорамы.

Следующие параметры URL являются необязательными:

Параметр Тип Описание Принятые значения
heading Необязательный Указывает направление движения камеры по компасу в градусах по часовой стрелке относительно севера. Значения в градусах от -180° до 360°
pitch Необязательный Задает угол наклона камеры — вверх или вниз. Положительные значения указывают на наклон камеры вверх, а отрицательные — вниз. Угол наклона по умолчанию, равный 0°, устанавливается на основе положения камеры в момент съемки. Поэтому угол наклона 0° часто, но не всегда, соответствует горизонтальному положению. Например, изображение, снятое на холме, скорее всего, будет иметь наклон по умолчанию, который не будет горизонтальным. Значения в градусах от -90° до 90°
fov Необязательный Определяет горизонтальное поле зрения изображения. По умолчанию — 90°. При работе с окном просмотра фиксированного размера поле зрения можно рассматривать как уровень масштабирования, при этом меньшие числа указывают на более высокий уровень масштабирования. Значение в градусах, диапазон от 10° до 100°.
center Необязательный Определяет центр отображения карты. Принимает значения широты и долготы, разделенные запятыми; например: 37.4218,-122.0840 .
zoom Необязательный Устанавливает начальный уровень масштабирования карты. Значения варьируются от 0 (весь мир) до 21 (отдельные здания). Верхний предел может меняться в зависимости от доступных картографических данных в выбранном местоположении.
maptype Необязательный Определяет тип загружаемых фрагментов карты. roadmap (по умолчанию) или satellite
language Необязательный Определяет язык, используемый для элементов пользовательского интерфейса и для отображения подписей на фрагментах карты. По умолчанию посетители будут видеть карту на своем родном языке. Этот параметр поддерживается только для некоторых фрагментов карты стран; если запрошенный язык не поддерживается для данного набора фрагментов, будет использоваться язык по умолчанию для этого набора фрагментов.
region Необязательный Определяет соответствующие границы и метки для отображения с учетом геополитической специфики. Принимает код региона, заданный в виде двухсимвольного (нечислового) субтега региона Unicode, соответствующего распространенным двухсимвольным значениям ccTLD («домен верхнего уровня»). См. подробную информацию о поддерживаемых регионах в разделе «Подробности покрытия платформы Google Maps» .

режим search

В режиме Search отображаются результаты поиска по видимой области карты. Рекомендуется указать местоположение для поиска, либо включив его в поисковый запрос ( record+stores+in+Seattle ), либо указав center и параметр zoom для ограничения области поиска.

https://www.google.com/maps/embed/v1/search
  ?key=YOUR_API_KEY
  &q=record+stores+in+Seattle

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

Параметр Тип Описание Принятые значения
q Необходимый Определяет поисковый запрос. Оно может включать географическое ограничение, например, in+Seattle или near+98033 .
center Необязательный Определяет центр отображения карты. Принимает значения широты и долготы, разделенные запятыми; например: 37.4218,-122.0840 .
zoom Необязательный Устанавливает начальный уровень масштабирования карты. Значения варьируются от 0 (весь мир) до 21 (отдельные здания). Верхний предел может меняться в зависимости от доступных картографических данных в выбранном местоположении.
maptype Необязательный Определяет тип загружаемых фрагментов карты. roadmap (по умолчанию) или satellite
language Необязательный Определяет язык, используемый для элементов пользовательского интерфейса и для отображения подписей на фрагментах карты. По умолчанию посетители будут видеть карту на своем родном языке. Этот параметр поддерживается только для некоторых фрагментов карты стран; если запрошенный язык не поддерживается для данного набора фрагментов, будет использоваться язык по умолчанию для этого набора фрагментов.
region Необязательный Определяет соответствующие границы и метки для отображения с учетом геополитической специфики. Принимает код региона, заданный в виде двухсимвольного (нечислового) субтега региона Unicode, соответствующего распространенным двухсимвольным значениям ccTLD («домен верхнего уровня»). См. подробную информацию о поддерживаемых регионах в разделе «Подробности покрытия платформы Google Maps» .

Параметры идентификатора места

API встраивания карт поддерживает использование идентификаторов мест вместо указания названия или адреса места. Идентификаторы мест — это надежный способ однозначной идентификации места. Для получения дополнительной информации см. документацию по API мест (новая) .

API для встраивания карт принимает идентификаторы мест в качестве следующих параметров URL:

  • q
  • origin
  • destination
  • waypoints

Чтобы использовать идентификатор места, необходимо сначала добавить префикс place_id: Следующий код указывает мэрию Нью-Йорка в качестве отправной точки для запроса маршрута: origin=place_id:ChIJs--MqP1YwokRBwAhjXWIHn8 .

  • radius задает радиус в метрах, в пределах которого следует искать панораму, центрированную на заданных широте и долготе. Допустимые значения — неотрицательные целые числа. Значение по умолчанию — 50.

  • source поиска по Street View только выбранными источниками. Допустимые значения:

    • default используются стандартные источники для просмотра улиц; поиск не ограничивается конкретными источниками.
    • Поиск по категориям outdoor ограничивается коллекциями, посвященными открытому пространству. Коллекции, посвященные внутренним помещениям, в результаты поиска не включаются. Обратите внимание, что панорамы, посвященные открытому пространству, могут отсутствовать в указанном местоположении. Также обратите внимание, что поиск возвращает только те панорамы, для которых можно определить, находятся ли они в помещении или на открытом воздухе. Например, панорамы PhotoSphere не возвращаются, поскольку неизвестно, находятся ли они в помещении или на открытом воздухе.
,

В этом руководстве показано, как встроить интерактивную карту на вашу веб-страницу.

Создайте URL-адрес API для встраивания карт.

Ниже приведён пример URL-адреса, загружающего API для встраивания карт:

https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS

Заменять:

Вставьте URL-адрес в iframe.

Чтобы использовать API встраивания карт на вашей веб-странице, укажите созданный вами URL-адрес в качестве значения атрибута src элемента iframe. Размер карты можно регулировать с помощью атрибутов height и width элемента iframe, например:

<iframe
  width="450"
  height="250"
  frameborder="0" style="border:0"
  referrerpolicy="strict-origin-when-cross-origin"
  src="https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS"
  allowfullscreen>
</iframe>

В приведенном выше примере iframe используются дополнительные свойства:

  • Свойство allowfullscreen позволяет отображать определенные части карты на весь экран.
  • Свойства frameborder="0" и style="border:0" позволяют удалить стандартную рамку iframe вокруг карты.
  • Свойство referrerpolicy="strict-origin-when-cross-origin" гарантирует, что браузер отправляет домен вашего веб-сайта в качестве заголовка Referer в Google. Это позволяет использовать ограничения по ключу API для проверки запроса, сохраняя при этом конфиденциальность конкретных путей к страницам.

Вы можете изменить размер iframe в соответствии со структурой и дизайном вашего веб-сайта, но мы заметили, что посетителям обычно удобнее взаимодействовать с картами большего размера. Обратите внимание, что встроенные карты не поддерживаются размером менее 200 пикселей ни по одному из параметров.

Ограничения, связанные с информацией о реферере и ключом API.

Если в метатеге referrer веб-сайта установлено значение no-referrer или same-origin , браузер не будет отправлять заголовок Referer в Google. Это может привести к тому, что ограничение по ключу API отклонит запросы. Для корректной работы ограничения добавьте свойство referrerpolicy к iframe, как в примере выше, чтобы явно разрешить отправку заголовков Referer в Google.

  • strict-origin-when-cross-origin (Рекомендуется): Отправляет в Google только ваш базовый домен (например, https://example.com/). Это обеспечивает конфиденциальность путей к вашим страницам, при этом сохраняя возможность использования ограничений по ключу API.
  • no-referrer-when-downgrade (Legacy): Отправляет весь URL-адрес, включая конкретные пути к страницам и параметры запроса (например, https://example.com/contact?user=123).

Узнайте больше о заголовке Referrer-Policy .

Выберите режимы карты

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

  • place : отображает на карте метку в определенном месте или по определенному адресу, например, в качестве ориентира, названия предприятия, географического объекта или названия города.
  • view : возвращает карту без маркеров и указаний.
  • directions отображает маршрут между двумя или более указанными точками на карте, а также расстояние и время в пути.
  • streetview : отображает интерактивные панорамные виды из указанных мест.
  • search : отображает результаты поиска по видимой области карты.

режим place

Следующая ссылка использует режим отображения place для показа маркера на карте, расположенного рядом с Эйфелевой башней:

https://www.google.com/maps/embed/v1/place
  ?key=YOUR_API_KEY
  &q=Eiffel+Tower,Paris+France

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

Параметр Тип Описание Принятые значения
q Необходимый Определяет местоположение маркера на карте. Название места, адрес, код или идентификатор места экранируются в URL-адресе. API встраивания карт поддерживает как + , так и %20 при экранировании пробелов. Например, преобразуйте "City Hall, New York, NY" в City+Hall,New+York,NY , или коды "849VCWC8+R9" в 849VCWC8%2BR9 .
center Необязательный Определяет центр отображения карты. Принимает значения широты и долготы, разделенные запятыми; например: 37.4218,-122.0840 .
zoom Необязательный Устанавливает начальный уровень масштабирования карты. Значения варьируются от 0 (весь мир) до 21 (отдельные здания). Верхний предел может меняться в зависимости от доступных картографических данных в выбранном местоположении.
maptype Необязательный Определяет тип загружаемых фрагментов карты. roadmap (по умолчанию) или satellite
language Необязательный Определяет язык, используемый для элементов пользовательского интерфейса и для отображения подписей на фрагментах карты. По умолчанию посетители будут видеть карту на своем родном языке. Этот параметр поддерживается только для некоторых фрагментов карты стран; если запрошенный язык не поддерживается для данного набора фрагментов, будет использоваться язык по умолчанию для этого набора фрагментов.
region Необязательный Определяет соответствующие границы и метки для отображения с учетом геополитической специфики. Принимает код региона, заданный в виде двухсимвольного (нечислового) субтега региона Unicode, соответствующего распространенным двухсимвольным значениям ccTLD («домен верхнего уровня»). См. подробную информацию о поддерживаемых регионах в разделе «Подробности покрытия платформы Google Maps» .

режим view

В следующем примере для отображения спутникового вида карты используются режим view и необязательный параметр maptype :

https://www.google.com/maps/embed/v1/view
  ?key=YOUR_API_KEY
  &center=-33.8569,151.2152
  &zoom=18
  &maptype=satellite

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

Параметр Тип Описание Принятые значения
center Необходимый Определяет центр отображения карты. Принимает значения широты и долготы, разделенные запятыми; например: 37.4218,-122.0840 .
zoom Необязательный Устанавливает начальный уровень масштабирования карты. Значения варьируются от 0 (весь мир) до 21 (отдельные здания). Верхний предел может меняться в зависимости от доступных картографических данных в выбранном местоположении.
maptype Необязательный Определяет тип загружаемых фрагментов карты. roadmap (по умолчанию) или satellite
language Необязательный Определяет язык, используемый для элементов пользовательского интерфейса и для отображения подписей на фрагментах карты. По умолчанию посетители будут видеть карту на своем родном языке. Этот параметр поддерживается только для некоторых фрагментов карты стран; если запрошенный язык не поддерживается для данного набора фрагментов, будет использоваться язык по умолчанию для этого набора фрагментов.
region Необязательный Определяет соответствующие границы и метки для отображения с учетом геополитической специфики. Принимает код региона, заданный в виде двухсимвольного (нечислового) субтега региона Unicode, соответствующего распространенным двухсимвольным значениям ccTLD («домен верхнего уровня»). См. подробную информацию о поддерживаемых регионах в разделе «Подробности покрытия платформы Google Maps» .

режим directions

В следующем примере используется режим directions для отображения пути между Ословом и Телемарком (Норвегия), расстояния и времени в пути, без учета платных дорог и автомагистралей.

https://www.google.com/maps/embed/v1/directions
  ?key=YOUR_API_KEY
  &origin=Oslo+Norway
  &destination=Telemark+Norway
  &avoid=tolls|highways

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

Параметр Тип Описание Принятые значения
origin Необходимый Определяет начальную точку, от которой будет отображаться маршрут. Название места, адрес, код, координаты широты/долготы или идентификатор места экранируются в URL-адресе. API встраивания карт поддерживает как + , так и %20 при экранировании пробелов. Например, преобразуйте "City Hall, New York, NY" в City+Hall,New+York,NY , или коды "849VCWC8+R9" в 849VCWC8%2BR9 .
destination Необходимый Определяет конечную точку направлений. Название места, адрес, код, координаты широты/долготы или идентификатор места экранируются в URL-адресе. API встраивания карт поддерживает как + , так и %20 при экранировании пробелов. Например, преобразуйте "City Hall, New York, NY" в City+Hall,New+York,NY , или коды "849VCWC8+R9" в 849VCWC8%2BR9 .
waypoints Необязательный Указывает одно или несколько промежуточных мест для прокладки маршрута между пунктом отправления и пунктом назначения. Название места, адрес или идентификатор места . Можно указать несколько путевых точек, разделяя их символом вертикальной черты (|) (например Berlin,Germany|Paris,France ). Можно указать до 20 путевых точек.
mode Необязательный Определяет способ передвижения. Если способ передвижения не указан, API Maps Embed отобразит один или несколько наиболее подходящих способов передвижения для указанного маршрута. driving , walking (предпочтительно по пешеходным дорожкам и тротуарам, где это возможно), bicycling (предпочтительно по маршрутам с велосипедными дорожками и улицами, где это возможно), transit или flying .
avoid Необязательный Указывает на особенности местности, которых следует избегать в маршруте. Обратите внимание, что это не исключает маршруты, включающие указанные особенности; это смещает результат в сторону более благоприятных маршрутов. tolls , ferries и/или highways . Разделяйте несколько значений символом вертикальной черты (например avoid=tolls|highways ).
units Необязательный Указывает метод измерения (метрический или имперский) при отображении расстояний в результатах. Если units не указаны, используемые единицы определяются страной origin запроса. metric или imperial мер
center Необязательный Определяет центр отображения карты. Принимает значения широты и долготы, разделенные запятыми; например: 37.4218,-122.0840 .
zoom Необязательный Устанавливает начальный уровень масштабирования карты. Значения варьируются от 0 (весь мир) до 21 (отдельные здания). Верхний предел может меняться в зависимости от доступных картографических данных в выбранном местоположении.
maptype Необязательный Определяет тип загружаемых фрагментов карты. roadmap (по умолчанию) или satellite
language Необязательный Определяет язык, используемый для элементов пользовательского интерфейса и для отображения подписей на фрагментах карты. По умолчанию посетители будут видеть карту на своем родном языке. Этот параметр поддерживается только для некоторых фрагментов карты стран; если запрошенный язык не поддерживается для данного набора фрагментов, будет использоваться язык по умолчанию для этого набора фрагментов.
region Необязательный Определяет соответствующие границы и метки для отображения с учетом геополитической специфики. Принимает код региона, заданный в виде двухсимвольного (нечислового) субтега региона Unicode, соответствующего распространенным двухсимвольным значениям ccTLD («домен верхнего уровня»). См. подробную информацию о поддерживаемых регионах в разделе «Подробности покрытия платформы Google Maps» .

режим streetview

API Maps Embed позволяет отображать изображения Street View в виде интерактивных панорам из заданных мест по всей зоне покрытия . Также доступны добавленные пользователями фотосферы и специальные коллекции Street View .

Каждая панорама Street View обеспечивает полный 360-градусный обзор из одной точки. Изображения содержат 360 градусов горизонтального обзора (полный круговой обзор) и 180 градусов вертикального обзора (от вертикального положения вверх до вертикального положения вниз). В режиме streetview окно просмотра отображает полученную панораму в виде сферы с камерой в центре. Вы можете управлять камерой, чтобы регулировать масштаб и ориентацию камеры.

Посмотрите на следующую панораму в режиме streetview :

https://www.google.com/maps/embed/v1/streetview
  ?key=YOUR_API_KEY
  &location=46.414382,10.013988
  &heading=210
  &pitch=10
  &fov=35

Для корректной работы требуется один из следующих параметров URL:

  • location принимает широту и долготу в виде значений, разделенных запятыми ( 46.414382,10.013988 10.013988). API отображает панораму, снятую ближе всего к этому местоположению. Поскольку изображения Street View периодически обновляются, и фотографии могут быть сделаны с немного разных позиций каждый раз, возможно, что при обновлении изображений ваше местоположение может автоматически переключиться на другую панораму.

  • pano — это конкретный идентификатор панорамы. Если вы указываете pano вы также можете указать location . location используется только в том случае, если API не может найти идентификатор панорамы.

Следующие параметры URL являются необязательными:

Параметр Тип Описание Принятые значения
heading Необязательный Указывает направление движения камеры по компасу в градусах по часовой стрелке относительно севера. Значения в градусах от -180° до 360°
pitch Необязательный Задает угол наклона камеры — вверх или вниз. Положительные значения указывают на наклон камеры вверх, а отрицательные — вниз. Угол наклона по умолчанию, равный 0°, устанавливается на основе положения камеры в момент съемки. Поэтому угол наклона 0° часто, но не всегда, соответствует горизонтальному положению. Например, изображение, снятое на холме, скорее всего, будет иметь наклон по умолчанию, который не будет горизонтальным. Значения в градусах от -90° до 90°
fov Необязательный Определяет горизонтальное поле зрения изображения. По умолчанию — 90°. При работе с окном просмотра фиксированного размера поле зрения можно рассматривать как уровень масштабирования, при этом меньшие числа указывают на более высокий уровень масштабирования. Значение в градусах, диапазон от 10° до 100°.
center Необязательный Определяет центр отображения карты. Принимает значения широты и долготы, разделенные запятыми; например: 37.4218,-122.0840 .
zoom Необязательный Устанавливает начальный уровень масштабирования карты. Значения варьируются от 0 (весь мир) до 21 (отдельные здания). Верхний предел может меняться в зависимости от доступных картографических данных в выбранном местоположении.
maptype Необязательный Определяет тип загружаемых фрагментов карты. roadmap (по умолчанию) или satellite
language Необязательный Определяет язык, используемый для элементов пользовательского интерфейса и для отображения подписей на фрагментах карты. По умолчанию посетители будут видеть карту на своем родном языке. Этот параметр поддерживается только для некоторых фрагментов карты стран; если запрошенный язык не поддерживается для данного набора фрагментов, будет использоваться язык по умолчанию для этого набора фрагментов.
region Необязательный Определяет соответствующие границы и метки для отображения с учетом геополитической специфики. Принимает код региона, заданный в виде двухсимвольного (нечислового) субтега региона Unicode, соответствующего распространенным двухсимвольным значениям ccTLD («домен верхнего уровня»). См. подробную информацию о поддерживаемых регионах в разделе «Подробности покрытия платформы Google Maps» .

режим search

В режиме Search отображаются результаты поиска по видимой области карты. Рекомендуется указать местоположение для поиска, либо включив его в поисковый запрос ( record+stores+in+Seattle ), либо указав center и параметр zoom для ограничения области поиска.

https://www.google.com/maps/embed/v1/search
  ?key=YOUR_API_KEY
  &q=record+stores+in+Seattle

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

Параметр Тип Описание Принятые значения
q Необходимый Определяет поисковый запрос. Оно может включать географическое ограничение, например, in+Seattle или near+98033 .
center Необязательный Определяет центр отображения карты. Принимает значения широты и долготы, разделенные запятыми; например: 37.4218,-122.0840 .
zoom Необязательный Устанавливает начальный уровень масштабирования карты. Значения варьируются от 0 (весь мир) до 21 (отдельные здания). Верхний предел может меняться в зависимости от доступных картографических данных в выбранном местоположении.
maptype Необязательный Определяет тип загружаемых фрагментов карты. roadmap (по умолчанию) или satellite
language Необязательный Определяет язык, используемый для элементов пользовательского интерфейса и для отображения подписей на фрагментах карты. По умолчанию посетители будут видеть карту на своем родном языке. Этот параметр поддерживается только для некоторых фрагментов карты стран; если запрошенный язык не поддерживается для данного набора фрагментов, будет использоваться язык по умолчанию для этого набора фрагментов.
region Необязательный Определяет соответствующие границы и метки для отображения с учетом геополитической специфики. Принимает код региона, заданный в виде двухсимвольного (нечислового) субтега региона Unicode, соответствующего распространенным двухсимвольным значениям ccTLD («домен верхнего уровня»). См. подробную информацию о поддерживаемых регионах в разделе «Подробности покрытия платформы Google Maps» .

Параметры идентификатора места

API встраивания карт поддерживает использование идентификаторов мест вместо указания названия или адреса места. Идентификаторы мест — это надежный способ однозначной идентификации места. Для получения дополнительной информации см. документацию по API мест (новая) .

API для встраивания карт принимает идентификаторы мест в качестве следующих параметров URL:

  • q
  • origin
  • destination
  • waypoints

Чтобы использовать идентификатор места, необходимо сначала добавить префикс place_id: Следующий код указывает мэрию Нью-Йорка в качестве отправной точки для запроса маршрута: origin=place_id:ChIJs--MqP1YwokRBwAhjXWIHn8 .

  • radius задает радиус в метрах, в пределах которого следует искать панораму, центрированную на заданных широте и долготе. Допустимые значения — неотрицательные целые числа. Значение по умолчанию — 50.

  • source поиска по Street View только выбранными источниками. Допустимые значения:

    • default используются стандартные источники для просмотра улиц; поиск не ограничивается конкретными источниками.
    • Поиск по категориям outdoor ограничивается коллекциями, посвященными открытому пространству. Коллекции, посвященные внутренним помещениям, в результаты поиска не включаются. Обратите внимание, что панорамы, посвященные открытому пространству, могут отсутствовать в указанном местоположении. Также обратите внимание, что поиск возвращает только те панорамы, для которых можно определить, находятся ли они в помещении или на открытом воздухе. Например, панорамы PhotoSphere не возвращаются, поскольку неизвестно, находятся ли они в помещении или на открытом воздухе.
,

В этом руководстве показано, как встроить интерактивную карту на вашу веб-страницу.

Создайте URL-адрес API для встраивания карт.

Ниже приведён пример URL-адреса, загружающего API для встраивания карт:

https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS

Заменять:

Вставьте URL-адрес в iframe.

Чтобы использовать API встраивания карт на вашей веб-странице, укажите созданный вами URL-адрес в качестве значения атрибута src элемента iframe. Размер карты можно регулировать с помощью атрибутов height и width элемента iframe, например:

<iframe
  width="450"
  height="250"
  frameborder="0" style="border:0"
  referrerpolicy="strict-origin-when-cross-origin"
  src="https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS"
  allowfullscreen>
</iframe>

В приведенном выше примере iframe используются дополнительные свойства:

  • Свойство allowfullscreen позволяет отображать определенные части карты на весь экран.
  • Свойства frameborder="0" и style="border:0" позволяют удалить стандартную рамку iframe вокруг карты.
  • Свойство referrerpolicy="strict-origin-when-cross-origin" гарантирует, что браузер отправляет домен вашего веб-сайта в качестве заголовка Referer в Google. Это позволяет использовать ограничения по ключу API для проверки запроса, сохраняя при этом конфиденциальность конкретных путей к страницам.

Вы можете изменить размер iframe в соответствии со структурой и дизайном вашего веб-сайта, но мы заметили, что посетителям обычно удобнее взаимодействовать с картами большего размера. Обратите внимание, что встроенные карты не поддерживаются размером менее 200 пикселей ни по одному из параметров.

Ограничения, связанные с информацией о реферере и ключом API.

Если в метатеге referrer веб-сайта установлено значение no-referrer или same-origin , браузер не будет отправлять заголовок Referer в Google. Это может привести к тому, что ограничение по ключу API отклонит запросы. Для корректной работы ограничения добавьте свойство referrerpolicy к iframe, как в примере выше, чтобы явно разрешить отправку заголовков Referer в Google.

  • strict-origin-when-cross-origin (Рекомендуется): Отправляет в Google только ваш базовый домен (например, https://example.com/). Это обеспечивает конфиденциальность путей к вашим страницам, при этом сохраняя возможность использования ограничений по ключу API.
  • no-referrer-when-downgrade (Legacy): Отправляет весь URL-адрес, включая конкретные пути к страницам и параметры запроса (например, https://example.com/contact?user=123).

Узнайте больше о заголовке Referrer-Policy .

Выберите режимы карты

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

  • place : отображает на карте метку в определенном месте или по определенному адресу, например, в качестве ориентира, названия предприятия, географического объекта или названия города.
  • view : возвращает карту без маркеров и указаний.
  • directions отображает маршрут между двумя или более указанными точками на карте, а также расстояние и время в пути.
  • streetview : отображает интерактивные панорамные виды из указанных мест.
  • search : shows results for a search across the visible map region.

place mode

The following URL uses the place map mode to display a map marker at the Eiffel Tower:

https://www.google.com/maps/embed/v1/place
  ?key=YOUR_API_KEY
  &q=Eiffel+Tower,Paris+France

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

Параметр Тип Описание Принятые значения
q Необходимый Defines map marker location. URL-escaped place name, address, plus code, or place ID . The Maps Embed API supports both + and %20 when escaping spaces. For example, convert "City Hall, New York, NY" to City+Hall,New+York,NY , or plus codes "849VCWC8+R9" to 849VCWC8%2BR9 .
center Необязательный Defines center of the map view. Accepts comma-separated latitude and longitude value; for example: 37.4218,-122.0840 .
zoom Необязательный Sets initial zoom level of the map. Values ranging from 0 (the whole world) to 21 (individual buildings). The upper limit can vary depending on the map data available at the selected location.
maptype Необязательный Defines type of map tiles to load. roadmap (default) or satellite
language Необязательный Defines the language to use for UI elements and for the display of labels on map tiles. By default, visitors will se a map in their own language. This parameter is only supported for some country tiles; if the specific language requested is not supported for the tile set, then the default language for that tileset will be used.
region Необязательный Defines the appropriate borders and labels to display, based on geo-political sensitivities. Accepts a region code specified as a two-character (non-numeric) unicode region subtag mapping to familiar ccTLD ("top-level domain") two-character values. See Google Maps Platform Coverage Details for supported regions.

режим view

The following example uses the view mode and optional maptype parameter to display a satellite view of the map:

https://www.google.com/maps/embed/v1/view
  ?key=YOUR_API_KEY
  &center=-33.8569,151.2152
  &zoom=18
  &maptype=satellite

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

Параметр Тип Описание Принятые значения
center Необходимый Defines center of the map view. Accepts comma-separated latitude and longitude value; for example: 37.4218,-122.0840 .
zoom Необязательный Sets initial zoom level of the map. Values ranging from 0 (the whole world) to 21 (individual buildings). The upper limit can vary depending on the map data available at the selected location.
maptype Необязательный Defines type of map tiles to load. roadmap (default) or satellite
language Необязательный Defines the language to use for UI elements and for the display of labels on map tiles. By default, visitors will se a map in their own language. This parameter is only supported for some country tiles; if the specific language requested is not supported for the tile set, then the default language for that tileset will be used.
region Необязательный Defines the appropriate borders and labels to display, based on geo-political sensitivities. Accepts a region code specified as a two-character (non-numeric) unicode region subtag mapping to familiar ccTLD ("top-level domain") two-character values. See Google Maps Platform Coverage Details for supported regions.

directions mode

The following example uses directions mode to display the path between Oslow and Telemark, Norway, the distance, and travel time avoiding tolls and highways.

https://www.google.com/maps/embed/v1/directions
  ?key=YOUR_API_KEY
  &origin=Oslo+Norway
  &destination=Telemark+Norway
  &avoid=tolls|highways

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

Параметр Тип Описание Принятые значения
origin Необходимый Defines the starting point from which to display directions. URL-escaped place name, address, plus code, latitude/longitude coordinates, or place ID . The Maps Embed API supports both + and %20 when escaping spaces. For example, convert "City Hall, New York, NY" to City+Hall,New+York,NY , or plus codes "849VCWC8+R9" to 849VCWC8%2BR9 .
destination Необходимый Defines the endpoint of the directions. URL-escaped place name, address, plus code, latitude/longitude coordinates, or place ID . The Maps Embed API supports both + and %20 when escaping spaces. For example, convert "City Hall, New York, NY" to City+Hall,New+York,NY , or plus codes "849VCWC8+R9" to 849VCWC8%2BR9 .
waypoints Необязательный Specifies one or more intermediary places to route directions between the origin and destination. Place name, address, or place ID . Multiple waypoints can be specified by using the pipe character (|) to separate places (eg Berlin,Germany|Paris,France ). You can specify up to 20 waypoints.
mode Необязательный Defines the method of travel. If no mode is specified the Maps Embed API will show one or more of the most relevant modes for the specified route. driving , walking (which prefers pedestrian paths and sidewalks, where available), bicycling (which prefers routes using bike paths and preferred streets where available), transit , or flying .
avoid Необязательный Specifies features to avoid in directions. Note that this doesn't preclude routes that include the restricted feature(s); it biases the result to more favorable routes. tolls , ferries and/or highways . Separate multiple values with the pipe character (eg avoid=tolls|highways ).
units Необязательный Specifies measurement method, metric or imperial, when displaying distances in the results. If units are not specified, the origin country of the query determines the units to use. metric or imperial
center Необязательный Defines center of the map view. Accepts comma-separated latitude and longitude value; for example: 37.4218,-122.0840 .
zoom Необязательный Sets initial zoom level of the map. Values ranging from 0 (the whole world) to 21 (individual buildings). The upper limit can vary depending on the map data available at the selected location.
maptype Необязательный Defines type of map tiles to load. roadmap (default) or satellite
language Необязательный Defines the language to use for UI elements and for the display of labels on map tiles. By default, visitors will se a map in their own language. This parameter is only supported for some country tiles; if the specific language requested is not supported for the tile set, then the default language for that tileset will be used.
region Необязательный Defines the appropriate borders and labels to display, based on geo-political sensitivities. Accepts a region code specified as a two-character (non-numeric) unicode region subtag mapping to familiar ccTLD ("top-level domain") two-character values. See Google Maps Platform Coverage Details for supported regions.

streetview mode

The Maps Embed API lets you display Street View images as interactive panoramas from designated locations throughout its coverage area . User contributed Photospheres , and Street View special collections are also available.

Each Street View panorama provides a full 360-degree view from a single location. Images contain 360 degrees of horizontal view (a full wrap-around) and 180 degrees of vertical view (from straight up to straight down). The streetview mode provides a viewer that renders the resulting panorama as a sphere with a camera at its center. You can manipulate the camera to control the zoom and the orientation of the camera.

See the following streetview mode panorama:

https://www.google.com/maps/embed/v1/streetview
  ?key=YOUR_API_KEY
  &location=46.414382,10.013988
  &heading=210
  &pitch=10
  &fov=35

One of the following URL parameters are required :

  • location accepts a latitude and a longitude as comma-separated values ( 46.414382,10.013988 ). The API displays the panorama photographed closest to this location. Because Street View imagery is periodically refreshed, and photographs may be taken from slightly different positions each time, it's possible that your location may snap to a different panorama when imagery is updated.

  • pano is a specific panorama ID. If you specify a pano you may also specify a location . The location is only used if the API cannot find the panorama ID.

The following URL parameters are optional:

Параметр Тип Описание Принятые значения
heading Необязательный Indicates the compass heading of the camera in degrees clockwise from North. Value in degrees from -180° to 360°
pitch Необязательный specifies the angle, up or down, of the camera. Positive values will angle the camera up, while negative values will angle the camera down. The default pitch of 0° is set based on on the position of the camera when the image was captured. Because of this, a pitch of 0° is often, but not always, horizontal. For example, an image taken on a hill will likely exhibit a default pitch that is not horizontal. Value in degrees from -90° to 90°
fov Необязательный determines the horizontal field of view of the image. It defaults to 90°. When dealing with a fixed-size viewport the field of view is can be considered the zoom level, with smaller numbers indicating a higher level of zoom. Value in degrees, with a range of 10° - 100°
center Необязательный Defines center of the map view. Accepts comma-separated latitude and longitude value; for example: 37.4218,-122.0840 .
zoom Необязательный Sets initial zoom level of the map. Values ranging from 0 (the whole world) to 21 (individual buildings). The upper limit can vary depending on the map data available at the selected location.
maptype Необязательный Defines type of map tiles to load. roadmap (default) or satellite
language Необязательный Defines the language to use for UI elements and for the display of labels on map tiles. By default, visitors will se a map in their own language. This parameter is only supported for some country tiles; if the specific language requested is not supported for the tile set, then the default language for that tileset will be used.
region Необязательный Defines the appropriate borders and labels to display, based on geo-political sensitivities. Accepts a region code specified as a two-character (non-numeric) unicode region subtag mapping to familiar ccTLD ("top-level domain") two-character values. See Google Maps Platform Coverage Details for supported regions.

режим search

Search mode displays results for a search across the visible map region. It's recommended that a location for the search be defined, either by including a location in the search term ( record+stores+in+Seattle ) or by including a center and zoom parameter to bound the search.

https://www.google.com/maps/embed/v1/search
  ?key=YOUR_API_KEY
  &q=record+stores+in+Seattle

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

Параметр Тип Описание Принятые значения
q Необходимый Defines the search term. It can include a geographic restriction, such as in+Seattle or near+98033 .
center Необязательный Defines center of the map view. Accepts comma-separated latitude and longitude value; for example: 37.4218,-122.0840 .
zoom Необязательный Sets initial zoom level of the map. Values ranging from 0 (the whole world) to 21 (individual buildings). The upper limit can vary depending on the map data available at the selected location.
maptype Необязательный Defines type of map tiles to load. roadmap (default) or satellite
language Необязательный Defines the language to use for UI elements and for the display of labels on map tiles. By default, visitors will se a map in their own language. This parameter is only supported for some country tiles; if the specific language requested is not supported for the tile set, then the default language for that tileset will be used.
region Необязательный Defines the appropriate borders and labels to display, based on geo-political sensitivities. Accepts a region code specified as a two-character (non-numeric) unicode region subtag mapping to familiar ccTLD ("top-level domain") two-character values. See Google Maps Platform Coverage Details for supported regions.

Place ID parameters

The Maps Embed API supports using place IDs instead of supplying a place name or address. Place IDs are stable way to uniquely identify a place. For more information, see the Places API (New) documentation .

The Maps Embed API accepts place IDs for the following URL parameters:

  • q
  • origin
  • destination
  • waypoints

To use a place ID, you must first add the prefix place_id: . The following code specifies New York City Hall as the origin for a directions request: origin=place_id:ChIJs--MqP1YwokRBwAhjXWIHn8 .

  • radius sets a radius, specified in meters, in which to search for a panorama, centered on the given latitude and longitude. Valid values are non-negative integers. Default value is 50.

  • source limits Street View searches to selected sources. Valid values are:

    • default uses the default sources for Street View; searches are not limited to specific sources.
    • outdoor limits searches to outdoor collections. Indoor collections are not included in search results. Note that outdoor panoramas may not exist for the specified location. Also note that the search only returns panoramas where it's possible to determine whether they're indoors or outdoors. For example, PhotoSpheres are not returned because it's unknown whether they are indoors or outdoors.
,

This guide shows how to embed an interactive map onto your web page.

Create the Maps Embed API URL

The following is an example URL that loads the Maps Embed API:

https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS

Заменять:

  • MAP_MODE with your map mode .
  • YOUR_API_KEY with your API key. For more information, see Get API key .
  • PARAMETERS with the required and optional parameters for your map mode.

Add the URL into an iframe

To use the Maps Embed API on your web page, set the URL you've built as the value of an iframe's src attribute. Control the map's size with the iframe's height and width attributes, for example:

<iframe
  width="450"
  height="250"
  frameborder="0" style="border:0"
  referrerpolicy="strict-origin-when-cross-origin"
  src="https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS"
  allowfullscreen>
</iframe>

The iframe sample above uses the additional properties:

  • The allowfullscreen property to allow certain map parts to go full screen.
  • The frameborder="0" and style="border:0" properties to remove the standard iframe border from around the map.
  • The referrerpolicy="strict-origin-when-cross-origin" property ensures the browser sends your website's domain as the Referer header to Google. This allows API key restrictions to validate the request, while keeping your specific page paths private.

You can resize the iframe to suit the structure and design of your own website, but we find that visitors usually find it easier to interact with larger maps. Note that embedded maps are not supported below a size of 200 px in either dimension.

Referrer information and API key restrictions

If the hosting website has a referrer meta tag being set to no-referrer or same-origin , the browser won't send the Referer header to Google. This may cause your API key restriction to reject the requests. For the restriction to work properly, add a referrerpolicy property to the iframe, as in the example above, to explicitly allow Referer headers to be sent to Google.

  • strict-origin-when-cross-origin (Recommended): Sends only your base domain (eg, https://example.com/) to Google. This keeps your specific page paths private while still allowing API key restrictions to function.
  • no-referrer-when-downgrade (Legacy): Sends the entire URL, including specific page paths and query parameters (eg, https://example.com/contact?user=123).

Learn more about the Referrer-Policy header.

Choose map modes

You can specify one of the following map modes to use in your request URL:

  • place : displays a map pin at a particular place or address, such as a landmark, business, geographic feature, or town.
  • view : returns a map with no markers or directions.
  • directions : displays the path between two or more specified points on the map, as well as the distance and travel time.
  • streetview : shows interactive panoramic views from designated locations.
  • search : shows results for a search across the visible map region.

place mode

The following URL uses the place map mode to display a map marker at the Eiffel Tower:

https://www.google.com/maps/embed/v1/place
  ?key=YOUR_API_KEY
  &q=Eiffel+Tower,Paris+France

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

Параметр Тип Описание Принятые значения
q Необходимый Defines map marker location. URL-escaped place name, address, plus code, or place ID . The Maps Embed API supports both + and %20 when escaping spaces. For example, convert "City Hall, New York, NY" to City+Hall,New+York,NY , or plus codes "849VCWC8+R9" to 849VCWC8%2BR9 .
center Необязательный Defines center of the map view. Accepts comma-separated latitude and longitude value; for example: 37.4218,-122.0840 .
zoom Необязательный Sets initial zoom level of the map. Values ranging from 0 (the whole world) to 21 (individual buildings). The upper limit can vary depending on the map data available at the selected location.
maptype Необязательный Defines type of map tiles to load. roadmap (default) or satellite
language Необязательный Defines the language to use for UI elements and for the display of labels on map tiles. By default, visitors will se a map in their own language. This parameter is only supported for some country tiles; if the specific language requested is not supported for the tile set, then the default language for that tileset will be used.
region Необязательный Defines the appropriate borders and labels to display, based on geo-political sensitivities. Accepts a region code specified as a two-character (non-numeric) unicode region subtag mapping to familiar ccTLD ("top-level domain") two-character values. See Google Maps Platform Coverage Details for supported regions.

режим view

The following example uses the view mode and optional maptype parameter to display a satellite view of the map:

https://www.google.com/maps/embed/v1/view
  ?key=YOUR_API_KEY
  &center=-33.8569,151.2152
  &zoom=18
  &maptype=satellite

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

Параметр Тип Описание Принятые значения
center Необходимый Defines center of the map view. Accepts comma-separated latitude and longitude value; for example: 37.4218,-122.0840 .
zoom Необязательный Sets initial zoom level of the map. Values ranging from 0 (the whole world) to 21 (individual buildings). The upper limit can vary depending on the map data available at the selected location.
maptype Необязательный Defines type of map tiles to load. roadmap (default) or satellite
language Необязательный Defines the language to use for UI elements and for the display of labels on map tiles. By default, visitors will se a map in their own language. This parameter is only supported for some country tiles; if the specific language requested is not supported for the tile set, then the default language for that tileset will be used.
region Необязательный Defines the appropriate borders and labels to display, based on geo-political sensitivities. Accepts a region code specified as a two-character (non-numeric) unicode region subtag mapping to familiar ccTLD ("top-level domain") two-character values. See Google Maps Platform Coverage Details for supported regions.

directions mode

The following example uses directions mode to display the path between Oslow and Telemark, Norway, the distance, and travel time avoiding tolls and highways.

https://www.google.com/maps/embed/v1/directions
  ?key=YOUR_API_KEY
  &origin=Oslo+Norway
  &destination=Telemark+Norway
  &avoid=tolls|highways

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

Параметр Тип Описание Принятые значения
origin Необходимый Defines the starting point from which to display directions. URL-escaped place name, address, plus code, latitude/longitude coordinates, or place ID . The Maps Embed API supports both + and %20 when escaping spaces. For example, convert "City Hall, New York, NY" to City+Hall,New+York,NY , or plus codes "849VCWC8+R9" to 849VCWC8%2BR9 .
destination Необходимый Defines the endpoint of the directions. URL-escaped place name, address, plus code, latitude/longitude coordinates, or place ID . The Maps Embed API supports both + and %20 when escaping spaces. For example, convert "City Hall, New York, NY" to City+Hall,New+York,NY , or plus codes "849VCWC8+R9" to 849VCWC8%2BR9 .
waypoints Необязательный Specifies one or more intermediary places to route directions between the origin and destination. Place name, address, or place ID . Multiple waypoints can be specified by using the pipe character (|) to separate places (eg Berlin,Germany|Paris,France ). You can specify up to 20 waypoints.
mode Необязательный Defines the method of travel. If no mode is specified the Maps Embed API will show one or more of the most relevant modes for the specified route. driving , walking (which prefers pedestrian paths and sidewalks, where available), bicycling (which prefers routes using bike paths and preferred streets where available), transit , or flying .
avoid Необязательный Specifies features to avoid in directions. Note that this doesn't preclude routes that include the restricted feature(s); it biases the result to more favorable routes. tolls , ferries and/or highways . Separate multiple values with the pipe character (eg avoid=tolls|highways ).
units Необязательный Specifies measurement method, metric or imperial, when displaying distances in the results. If units are not specified, the origin country of the query determines the units to use. metric or imperial
center Необязательный Defines center of the map view. Accepts comma-separated latitude and longitude value; for example: 37.4218,-122.0840 .
zoom Необязательный Sets initial zoom level of the map. Values ranging from 0 (the whole world) to 21 (individual buildings). The upper limit can vary depending on the map data available at the selected location.
maptype Необязательный Defines type of map tiles to load. roadmap (default) or satellite
language Необязательный Defines the language to use for UI elements and for the display of labels on map tiles. By default, visitors will se a map in their own language. This parameter is only supported for some country tiles; if the specific language requested is not supported for the tile set, then the default language for that tileset will be used.
region Необязательный Defines the appropriate borders and labels to display, based on geo-political sensitivities. Accepts a region code specified as a two-character (non-numeric) unicode region subtag mapping to familiar ccTLD ("top-level domain") two-character values. See Google Maps Platform Coverage Details for supported regions.

streetview mode

The Maps Embed API lets you display Street View images as interactive panoramas from designated locations throughout its coverage area . User contributed Photospheres , and Street View special collections are also available.

Each Street View panorama provides a full 360-degree view from a single location. Images contain 360 degrees of horizontal view (a full wrap-around) and 180 degrees of vertical view (from straight up to straight down). The streetview mode provides a viewer that renders the resulting panorama as a sphere with a camera at its center. You can manipulate the camera to control the zoom and the orientation of the camera.

See the following streetview mode panorama:

https://www.google.com/maps/embed/v1/streetview
  ?key=YOUR_API_KEY
  &location=46.414382,10.013988
  &heading=210
  &pitch=10
  &fov=35

One of the following URL parameters are required :

  • location accepts a latitude and a longitude as comma-separated values ( 46.414382,10.013988 ). The API displays the panorama photographed closest to this location. Because Street View imagery is periodically refreshed, and photographs may be taken from slightly different positions each time, it's possible that your location may snap to a different panorama when imagery is updated.

  • pano is a specific panorama ID. If you specify a pano you may also specify a location . The location is only used if the API cannot find the panorama ID.

The following URL parameters are optional:

Параметр Тип Описание Принятые значения
heading Необязательный Indicates the compass heading of the camera in degrees clockwise from North. Value in degrees from -180° to 360°
pitch Необязательный specifies the angle, up or down, of the camera. Positive values will angle the camera up, while negative values will angle the camera down. The default pitch of 0° is set based on on the position of the camera when the image was captured. Because of this, a pitch of 0° is often, but not always, horizontal. For example, an image taken on a hill will likely exhibit a default pitch that is not horizontal. Value in degrees from -90° to 90°
fov Необязательный determines the horizontal field of view of the image. It defaults to 90°. When dealing with a fixed-size viewport the field of view is can be considered the zoom level, with smaller numbers indicating a higher level of zoom. Value in degrees, with a range of 10° - 100°
center Необязательный Defines center of the map view. Accepts comma-separated latitude and longitude value; for example: 37.4218,-122.0840 .
zoom Необязательный Sets initial zoom level of the map. Values ranging from 0 (the whole world) to 21 (individual buildings). The upper limit can vary depending on the map data available at the selected location.
maptype Необязательный Defines type of map tiles to load. roadmap (default) or satellite
language Необязательный Defines the language to use for UI elements and for the display of labels on map tiles. By default, visitors will se a map in their own language. This parameter is only supported for some country tiles; if the specific language requested is not supported for the tile set, then the default language for that tileset will be used.
region Необязательный Defines the appropriate borders and labels to display, based on geo-political sensitivities. Accepts a region code specified as a two-character (non-numeric) unicode region subtag mapping to familiar ccTLD ("top-level domain") two-character values. See Google Maps Platform Coverage Details for supported regions.

режим search

Search mode displays results for a search across the visible map region. It's recommended that a location for the search be defined, either by including a location in the search term ( record+stores+in+Seattle ) or by including a center and zoom parameter to bound the search.

https://www.google.com/maps/embed/v1/search
  ?key=YOUR_API_KEY
  &q=record+stores+in+Seattle

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

Параметр Тип Описание Принятые значения
q Необходимый Defines the search term. It can include a geographic restriction, such as in+Seattle or near+98033 .
center Необязательный Defines center of the map view. Accepts comma-separated latitude and longitude value; for example: 37.4218,-122.0840 .
zoom Необязательный Sets initial zoom level of the map. Values ranging from 0 (the whole world) to 21 (individual buildings). The upper limit can vary depending on the map data available at the selected location.
maptype Необязательный Defines type of map tiles to load. roadmap (default) or satellite
language Необязательный Defines the language to use for UI elements and for the display of labels on map tiles. By default, visitors will se a map in their own language. This parameter is only supported for some country tiles; if the specific language requested is not supported for the tile set, then the default language for that tileset will be used.
region Необязательный Defines the appropriate borders and labels to display, based on geo-political sensitivities. Accepts a region code specified as a two-character (non-numeric) unicode region subtag mapping to familiar ccTLD ("top-level domain") two-character values. See Google Maps Platform Coverage Details for supported regions.

Place ID parameters

The Maps Embed API supports using place IDs instead of supplying a place name or address. Place IDs are stable way to uniquely identify a place. For more information, see the Places API (New) documentation .

The Maps Embed API accepts place IDs for the following URL parameters:

  • q
  • origin
  • destination
  • waypoints

To use a place ID, you must first add the prefix place_id: . The following code specifies New York City Hall as the origin for a directions request: origin=place_id:ChIJs--MqP1YwokRBwAhjXWIHn8 .

  • radius sets a radius, specified in meters, in which to search for a panorama, centered on the given latitude and longitude. Valid values are non-negative integers. Default value is 50.

  • source limits Street View searches to selected sources. Valid values are:

    • default uses the default sources for Street View; searches are not limited to specific sources.
    • outdoor limits searches to outdoor collections. Indoor collections are not included in search results. Note that outdoor panoramas may not exist for the specified location. Also note that the search only returns panoramas where it's possible to determine whether they're indoors or outdoors. For example, PhotoSpheres are not returned because it's unknown whether they are indoors or outdoors.