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-backend.googleapis.com. - Аутентификация: ключ API.
- Начало работы: настройка Maps Embed API
- Документация: документация по Maps Embed 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
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.