Облачные ресурсы для работы со стилями карт (бета)

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

Создавать и изменять стили и идентификаторы карт в проекте Google Cloud могут только владельцы и редакторы проектов с правами на управление учетными данными и доступом (IAM).

Как создать идентификаторы карт

Идентификатор карты – это уникальный идентификатор конкретного экземпляра карты Google. В Google Cloud Console вы можете создавать идентификаторы карт и изменять стили, связанные с идентификаторами, не редактируя встроенный JSON-код приложения, предназначенный для настройки стилей.

Для этого выполните следующие действия:

  1. Откройте Cloud Console и перейдите на страницу Управление картой.

    Перейти на страницу "Управление картой"

  2. Нажмите Создать идентификатор карты. В Cloud Console откроется форма.

    Создание идентификатора карты

    В этой форме выполните следующие действия:

    • Укажите название карты.
    • Выберите тип или платформу карты.
    • Введите описание карты.
    • Нажмите Далее. Вы увидите на экране созданный идентификатор карты.

Как установить Maps SDK для Android (бета)

Облачные ресурсы для работы со стилями карт пока недоступны в библиотеке сервисов Google Play. Однако вы можете протестировать их с помощью Maps SDK для Android (бета).

Инструкции по установке SDK приведены в этой статье.

Как добавить идентификаторы карт в существующий компонент MapFragment

Вы можете добавить идентификатор карты в элемент <fragment> файла макета для объекта activity. Это можно сделать с помощью класса MapView или программным способом, с помощью класса GoogleMapOptions.

Допустим, вы создали идентификатор карты, который хранится в строковом значении map_id в файле res/values/strings.xml:

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <string name="map_id">YOUR_MAP_ID</string>
</resources>

Если карта добавлена с помощью элемента <fragment> в файле фрагмента для объекта activity, то во всех фрагментах карты с этим стилем должен быть указан идентификатор карты в атрибуте map:mapId:

<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
    class="com.google.android.libraries.maps.SupportMapFragment"
    …
    map:mapId="@string/map_id" />

Указать идентификатор карты можно также с помощью атрибута map:mapId класса MapView:

<com.google.android.gms.maps.MapView
    xmlns:android="http://schemas.android.com/apk/res/android"
    ....
    map:mapId="@string/map_id" />

Чтобы указать идентификатор карты программным способом, передайте его в экземпляр MapFragment с помощью класса GoogleMapOptions:

Java

MapFragment mapFragment = MapFragment.newInstance(
    new GoogleMapOptions()
        .mapId(getResources().getString(R.string.map_id)));
      

Kotlin

val mapFragment = MapFragment.newInstance(
    GoogleMapOptions()
        .mapId(resources.getString(R.string.map_id))
)
      

Создайте и запустите приложение в Android Studio, как обычно. Собственные стили, настроенные на первом этапе, будут применены ко всем картам с идентификаторами.

Как создать стиль карты

Стиль карты – это уникальный идентификатор набора настроек, который можно связать с любым идентификатором карты.

Чтобы создать новый стиль, выполните следующие действия:

  1. Откройте Google Cloud Console и перейдите на страницу Стили карты.

    Перейти на страницу "Стили карты"

  2. Нажмите Создать стиль карты. Откроется страница Новый стиль карт.

  3. На странице Новый стиль карт вы можете:

    1. выбрать один из шаблонов стилей;
    2. импортировать код JSON, вставив его в текстовое поле на вкладке Импорт кода JSON;
    3. выбрать стиль карты, настроенный в соответствии с целями для определенной сферы деятельности (путешествия, логистика, недвижимость и розничная торговля).

    Вы можете внести дополнительные изменения в объекты карты, нажав Настроить в редакторе стилей. Подробнее…

  4. Чтобы сохранить название стиля карты и внесенные изменения, нажмите Сохранить.

Как обновить настройки стиля

Вы можете выбрать стиль на странице Стили карты и выполнить следующие действия:

  • Продолжить настройку стиля или посмотреть уже заданные для него параметры в редакторе стилей. Для этого нажмите кнопку Настроить стиль. Подробнее…

  • Изменить название или описание стиля. Для этого нажмите кнопку Изменить.

  • Создать копию стиля. Для этого нажмите кнопку Создать копию.

  • Удалить стиль. Для этого нажмите кнопку Удалить.

  • Посмотреть идентификаторы карт, связанные с этим стилем.

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

Пример приложения

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

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

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

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

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