Обзор Map Management API

Map Management API – это REST API, который позволяет программно управлять ресурсами облачных стилей карт. С помощью этого API вы можете определять внешний вид карт, управлять их идентификаторами и связывать собственные стили и наборы данных с определенными вариантами карт, не используя Cloud Console.

Map Management API предназначен для разработчиков, которым нужно управлять конфигурациями карт в больших масштабах или интегрировать стили карт в собственные автоматизированные рабочие процессы и внутренние инструменты.

Справочные ресурсы

  • StyleConfig – содержит JSON-представление стиля карты. Они определяют цвета, видимость и плотность объектов на карте.
  • MapConfig – уникальный идентификатор карты. Он служит контейнером для настроек стилей и таких функций, как выделение объектов инфраструктуры или сглаживание зданий.
  • MapContextConfig связывает StyleConfig (и, при необходимости, один или несколько наборов данных) с определенными MapVariants в MapConfig.

Каналы версий API

В Map Management API используется версионирование на основе каналов, чтобы обеспечить понятный путь от экспериментальных функций до стабильных общедоступных.

  • v2alpha (экспериментальная). Содержит новейшие экспериментальные функции. Функции в этом канале могут меняться без уведомления и не рекомендуются для использования в рабочей среде.
  • v2beta (предварительная версия). Содержит стабильные функции, которые готовятся к общей доступности. Этот канал подходит для раннего внедрения и тестирования в опытных средах.
  • v2 (общая доступность). Содержит полностью поддерживаемые функции, готовые к использованию в рабочей среде.

Большинство функций версии 2 доступны в конечных точках v2alpha и v2beta на соответствующих этапах внедрения. Новым пользователям рекомендуется начинать с конечной точки v2beta.

Аутентификация

Для аутентификации в Map Management API можно использовать только OAuth 2.0. Ключи API не поддерживаются. Подробнее об использовании OAuth…

Ограничения

  • Роли разработчиков. Чтобы использовать Map Management API, у вас должны быть необходимые разрешения IAM для управления ресурсами платформы Google Карт в облачном проекте Google Cloud.
  • Область действия ресурса. Этот API предназначен для управления ресурсами облачных стилей карт. Для других настроек платформы Google Карт по-прежнему может требоваться Cloud Console.

Расходы

Map Management API предоставляется бесплатно. Вызовы API будут отображаться на странице "Оплата" в Cloud Console, но плата за них взиматься не будет. Однако на запросы накладываются следующие ограничения:

  • 3 запроса в секунду;
  • 180 запросов в минуту для проекта (обновляется каждую минуту);
  • 100 000 запросов в день на проект (обновляется ежедневно).

Подробнее об использовании и оплате…