Облачные стили карт

Выберите платформу: Android iOS JavaScript Веб-сервисы

На платформе Google Карт есть облачные функции для работы со стилями, позволяющие с легкостью управлять стилями карт с помощью Google Cloud Console и делать карты удобнее для пользователей, не обновляя код приложений после каждого изменения стиля.

Стили, созданные до 15 сентября 2020 г., не поддерживают улучшенное отображение природных объектов. Если вы хотите использовать такие объекты, создайте новый стиль карты.

Облачные стили карт позволяют создавать и изменять стили для любых приложений, в которых используются Google Карты, без внесения изменений в код после добавления идентификатора карты. Все изменения стилей осуществляются в Cloud Console без какого-либо кодирования. Можно изменять вид и цвет множества элементов карты, таких как дороги, здания, водные объекты, объекты инфраструктуры и транзитные маршруты.

Доступны следующие функции:

Облачные стили. Вместо того чтобы писать код JSON, вы можете работать с внешним видом динамических и статических карт непосредственно в Cloud Console, используя идентификаторы и стили карт.
Фильтрация бизнес-объектов. Все объекты разделены на пять категорий, которые можно показывать или не показывать на карте.
Настройки плотности объектов. Вы можете указать, какой должна быть плотность объектов на базовой карте по умолчанию.

Облачные стили карт доступны в Maps SDK для Android¹, Maps SDK для iOS, JavaScript и Maps Static API. Однако не все функции доступны на всех платформах.

Подготовка

Создайте идентификатор карты
Чтобы использовать облачные стили, загрузка карты должна осуществляться с помощью идентификатора карты.
Откажитесь от стилей, заданных в коде
Перед добавлением идентификатора для существующей карты со стилем, заданным в коде, например JSON или параметрами запроса URL, рекомендуется удалить заданный в коде стиль, чтобы избежать возможных конфликтов с будущими функциями. Можно импортировать стилизацию JSON в новый стиль карты.
- Для Android обновите MapStyleOptions
- Для iOS обновите класс GMSMapStyle
- Для JavaScript удалите стилизацию MapTypeStyle
- Для Maps Static удалите параметр style

*Обновите Maps SDK для Android
Чтобы использовать облачные стили карт, требуется Maps SDK для Android 18.0.0 или более поздней версии и средство отрисовки Maps SDK для Android последней версии.

Оплата

Для использования облачных стилей карт требуется идентификатор карты. Использование идентификатора карты в Maps SDK для Android, Maps SDK для iOS или JavaScript требует оплаты по коду Dynamic Maps. Использование идентификатора карты в Maps Static API требует оплаты по коду Static Maps.

Примеры

Запустите пример приложения ApiDemos

Чтобы запустить пример приложения ApiDemos, посмотрите пример на GitHub (для Java или Kotlin) и демонстрацию использования CloudBasedMapStylingDemoActivity (для Java или Kotlin).

Чтобы увидеть, как работают облачные стили карт для Android, вы можете ознакомиться с примерами приложений на языках Java и Kotlin.

Известные проблемы

Если ваше приложение уже доступно для пользователей, то собственные стили карт с идентификаторами можно обновлять через Google Cloud Console. Новый стиль применяется не сразу, а в течение нескольких часов.

Чтобы можно было увидеть новый стиль сразу же (например, для тестирования), удалите данные приложения с тестового устройства. О том, как это сделать, читайте в Справочном центре Android.

Учтите, что настройки зависят от смартфона. За дополнительной информацией обратитесь к производителю устройства.

Облачные стили карт недоступны в упрощенном режиме Android. ↩