Начать

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

Выполните следующие действия, чтобы настроить стиль границ на основе данных.

Включить новый рендерер карт

Обновленный модуль рендеринга карт доступен начиная с версии 18.0.0 Maps SDK для Android. Этот модуль рендеринга привносит в Maps SDK для Android множество улучшений, включая поддержку стилей облачных карт.

С выпуском версии 18.2.0 Maps SDK для Android компания Google заменила устаревший модуль визуализации по умолчанию на обновленный модуль визуализации карт. Это изменение означает, что обновленный модуль рендеринга карт теперь используется по умолчанию в вашем приложении при создании нового приложения или пересоздании существующего приложения.

Внимание: Чтобы использовать стиль на основе данных для границ в вашем приложении, ваше приложение должно быть создано с использованием обновленного средства визуализации карт. Если вы добавляете стили для границ на основе данных в существующее приложение, обязательно перестройте приложение, чтобы оно использовало обновленный механизм рендеринга карт. Дополнительную информацию см. в разделе «Новый модуль визуализации карт» .

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

Чтобы создать новый идентификатор карты, выполните действия, описанные в разделе Создание идентификатора карты . Убедитесь, что в качестве типа карты установлено значение Android .

Создайте новый стиль карты

Чтобы создать новый стиль карты, следуйте инструкциям в разделе «Управление стилями карты» , чтобы создать стиль и связать его с только что созданным идентификатором карты .

Выберите векторные слои в новом стиле карты.

В консоли Google API вы можете выбрать, какие векторные слои отображать для вашего нового стиля карты. Слой объектов определяет, какие типы границ появляются на карте (например, населенные пункты, штаты и т. д.).

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

1. В консоли Google API перейдите на страницу «Стили карт» .
2. Выберите проект, если будет предложено.
3. Выберите стиль карты.
4. Щелкните раскрывающийся список Слои объектов , чтобы добавить или удалить слои.
5. Нажмите «Сохранить» , чтобы сохранить изменения и сделать их доступными для ваших карт.

Обновите код инициализации карты.

Для этого шага требуется идентификатор карты, который вы только что создали. Его можно найти на странице управления картами .

Чтобы добавить идентификатор карты в код инициализации, см. раздел Добавление идентификатора карты в приложение .

Получить доступ к векторному слою карты

Вы используете объект FeatureLayer для представления каждого векторного слоя карты, например векторного слоя почтового индекса или местоположения. Чтобы получить доступ к объекту векторного слоя, вызовите GoogleMap.getFeatureLayer() при инициализации карты:

Ява

private FeatureLayer postalCodeLayer;

@Override
public void onMapReady(GoogleMap map) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build());
  ...
}

Котлин

private var postalCodeLayer: FeatureLayer? = null

override fun onMapReady(googleMap: GoogleMap) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = googleMap.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build())
  ...
}

Передайте объект FeatureLayerOptions в getFeatureLayer() чтобы указать тип векторного слоя. В этом примере вы хотите получить доступ к слою POSTAL_CODE . Создайте отдельный объект FeatureLayer для каждого слоя, который вы хотите стилизовать.

Получив объект FeatureLayer , вы можете применить стиль к граничным полигонам этого объекта.

Примечание. Если для карты не существует FeatureLayer указанного типа или если управление границами на основе данных не включено, поскольку вы не указали идентификатор карты, этот вызов возвращает результат, но регистрирует ошибку. Используйте метод FeatureLayer.isAvailable() , чтобы определить, доступен ли FeatureLayer .

Проверьте возможности карты (обязательно)

Для оформления границ на основе данных требуется идентификатор карты. Если идентификатор карты отсутствует или передан недопустимый идентификатор карты, управляемый данными стиль для границ не может загрузиться. В качестве шага по устранению неполадок вы можете использовать MapCapabilities , чтобы проверить, поддерживается ли стиль границ на основе данных.

Внимание: некоторые устройства могут не поддерживать новый модуль рендеринга карт и, следовательно, не могут отображать стили границ на основе данных. Вы должны использовать MapCapabilities для проверки поддержки во время выполнения. Если стиль границ на основе данных не поддерживается, определите запасной вариант. Требования к устройствам для нового средства визуализации карт см. в разделе Поддерживаемые устройства .

Котлин

val capabilities: MapCapabilities = googleMap.getMapCapabilities()
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable())

Ява

MapCapabilities capabilities = googleMap.getMapCapabilities();
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable());