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

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

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

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

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

Заменять:

• MAP_MODE с режимом вашей карты .
• YOUR_API_KEY с вашим ключом API. Подробнее см. в разделе «Получить ключ API» .
• PARAMETERS с обязательными и необязательными параметрами для вашего режима карты.

Добавьте URL в iframe

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

<iframe
  width="450"
  height="250"
  frameborder="0" style="border:0"
  referrerpolicy="no-referrer-when-downgrade"
  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="no-referrer-when-downgrade" позволяет браузеру отправлять полный URL-адрес в качестве заголовка Referer с запросом, чтобы ограничения ключа API могли работать правильно.

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

Ограничения API-ключа

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

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

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

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

режим place

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

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

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

режим view

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

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

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

режим directions

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

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

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

режим 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 ). API отображает панораму, снятую ближе всего к этому месту. Поскольку изображения Street View периодически обновляются, и фотографии могут быть сделаны с немного разных точек каждый раз, возможно, что ваше местоположение будет привязано к другой панораме при обновлении изображения.

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

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

режим 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

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

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

API Maps Embed поддерживает использование идентификаторов мест вместо указания названия или адреса. Идентификаторы мест — это стабильный способ уникальной идентификации места. Подробнее см. в документации API Google Places .

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

• q
• origin
• destination
• waypoints

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

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

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

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