Краткий справочник по Maps Embed API

Maps Embed API позволяет разместить на веб-странице интерактивную карту или панораму в Просмотре улиц с помощью HTTP-запроса, заданного как URL элемента iframe src. При этом не требуется использовать JavaScript. Поддерживаются следующие режимы карты: place, view, directions, streetview и search.

Maps Embed API: основные факты

  • Продукт: Maps Embed API.
  • Другие названия: Google Maps Embed API, Maps Embed.
  • Категория: Карты
  • Платформа: JavaScript (браузер).
  • Где выполняется: на стороне клиента (в коде приложения или браузера).
  • Стадия запуска: GA
  • Жизненный цикл: активно.
  • Обзор: Обзор Maps Embed API
  • Регионы: все страны. Режим просмотра улиц зависит от доступности этой функции. Параметр region принимает регионы, перечисленные на странице сведений о доступности платформы Google Карт. (подробнее о покрытии)

Maps Embed API: когда использовать

Используйте Maps Embed API, если:

  • Вам нужно добавить на веб-страницу интерактивную карту или панораму в Просмотре улиц, используя только HTML iframe без JavaScript.
  • Вам нужно показать маркер места, вид карты, маршрут между точками или результаты поиска по области на встроенной карте.
  • Вам нужна встроенная карта без платы за запрос и без ограничений на количество запросов в секунду или в день (ключ API по-прежнему требуется).

Не используйте Maps Embed API, если:

  • Вам нужно настроить веб-карту, добавив на нее собственный контент и изображения. Используйте Maps JavaScript API.
  • Вам нужно расширить встроенную карту с помощью программных функций, не ограничиваясь параметрами URL в iframe. Используйте Maps JavaScript API.

Maps Embed API: настройка

Maps Embed API: распространенные ошибки

  • Проблема. Если на хост-странице для метатега referrer задано значение no-referrer или same-origin, браузер не отправляет заголовок Referer, и ключ API, ограниченный по заголовку HTTP referer, может отклонять запросы на встраивание. Решение. Добавьте referrerpolicy="strict-origin-when-cross-origin" в iframe, чтобы домен сайта отправлялся в Google. Подробнее: /maps/documentation/embed/embedding-map.
  • Проблема. Встроенные карты не поддерживаются, если их размер меньше 200 пикселей по любому измерению. Решение. Задайте для атрибутов width и height тега iframe значение не менее 200 пикселей. Подробнее: /maps/documentation/embed/embedding-map.
  • Проблема. Даже если использование бесплатное, на карте появляется водяной знак "Только для разработки", если не включена оплата, способ оплаты недействителен, превышено установленное пользователем дневное ограничение или в запросе отсутствует HTTP-заголовок Referer при использовании ключа с ограничением по источнику перехода. Решение. Включите платежные функции в проекте, указав действительный способ оплаты, увеличьте или отмените установленный вами суточный лимит квоты и убедитесь, что для ключей с ограничением по источнику ссылки отправляется источник ссылки (например, с помощью referrerpolicy="strict-origin-when-cross-origin" в окне iframe). Подробнее: /maps/documentation/embed/error-messages.
  • Проблема. Если запрос недействителен (неверные или отсутствующие параметры, ошибки ключа API и квоты, например отсутствующий или недействительный ключ, отключенный Maps Embed API или нарушение ограничений ключа), в консоли браузера появляется только код статуса HTTP 4xx, а не описательное сообщение. Текст ошибки появляется внутри iframe вместо карты. Решение. Прочитайте текст ошибки в iframe и код статуса в консоли (400 – ошибка параметра, 401 – отсутствует ключ, 403 – недействительный ключ). Затем убедитесь, что параметры и ключ действительны, Maps Embed API включен, а ограничения ключа разрешают запрос. Подробнее: /maps/documentation/embed/error-messages.

Что можно делать с помощью Maps Embed API

Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.

Maps Embed API: маршруты и навигация

Maps Embed API: карты

Maps Embed API: Places

Maps Embed API: Просмотр улиц