Обзор API управления картами

API управления картами — это RESTful API, который позволяет программно управлять ресурсами оформления облачных карт. С помощью этого API вы можете определять визуальное оформление карт, управлять идентификаторами карт и связывать пользовательские стили и наборы данных с конкретными вариантами карт — и все это без использования облачной консоли.

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

Ключевые ресурсы

• StyleConfig : Содержит JSON-представление стиля карты. Определяет цвета, видимость и плотность объектов на карте.
• MapConfig : Представляет собой уникальный идентификатор карты (Map ID). Он служит контейнером для настроек стиля и таких функций, как повышение видимости POI или выравнивание зданий.
• MapContextConfig : Связывает StyleConfig (и, при необходимости, один или несколько Datasets) с конкретными MapVariants внутри MapConfig .

Каналы версионирования API

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

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

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

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

Для аутентификации в API управления картами можно использовать только OAuth 2.0, который не поддерживает ключи API. Дополнительную информацию см. в разделе «Использование OAuth» .

Ограничения

• Роли разработчика : Для использования API управления картами вам необходимы соответствующие разрешения IAM для управления ресурсами платформы Google Maps в вашем проекте Google Cloud.
• Область применения : Этот API ориентирован на управление облачными ресурсами для оформления карт. Для других конфигураций платформы Google Maps может потребоваться облачная консоль.

Затраты

Использование API управления картами бесплатно. Вызовы API отображаются на странице «Платежи» в консоли Cloud, но стоимость будет равна 0 долларов. Однако количество запросов ограничено следующим образом:

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

См. раздел «Использование и выставление счетов» .