Начало работы

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

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

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

Идентификатор карты (mapID) — это уникальный идентификатор, представляющий собой отдельный экземпляр карты Google. Вы можете создавать идентификаторы карт и обновлять стиль, связанный с идентификатором карты, в любое время в консоли Google Cloud.

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

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

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

Выберите слои объектов

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

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

Управление слоями объектов

1. В консоли Google Cloud перейдите на страницу «Стили карт» .

2. При появлении запроса выберите проект.

3. Выберите стиль карты.

4. Чтобы добавить или удалить слои, щелкните раскрывающийся список « Слои объектов» .

5. Нажмите «Сохранить» , чтобы сохранить изменения и сделать их доступными для ваших карт.

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

На этом этапе необходимо связать идентификатор карты со стилем, в котором включен один или несколько слоев объектов. Чтобы убедиться в правильности настройки идентификатора карты в консоли Cloud, проверьте, как он настроен в разделе «Управление картами» .

Быстрый

// A map ID using a style with one or more feature layers enabled

let mapID = GMSMapID(identifier: "YOUR_MAP_ID")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: GMSCameraPosition(latitude: 40, longitude: -80, zoom: 7))

Objective-C

// A map ID using a style with one or more feature layers enabled

GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"MAP_ID"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:[GMSCameraPosition cameraWithLatitude:40 longitude:-80 zoom:7]];

Важно: для тестирования вы можете пропустить этап создания и настройки идентификатора карты , используя mapId: DEMO_MAP_ID в коде вашего приложения. DEMO_MAP_ID предназначен только для целей тестирования. Не используйте DEMO_MAP_ID в производственной среде.

Добавление слоев объектов на карту

Чтобы получить ссылку на слой объектов на вашей карте, вызовите mapView.featureLayer(of:) при инициализации карты:

Быстрый

let layer = mapView.featureLayer(of: .locality)

Objective-C

GMSFeatureLayer *layer = [mapView featureLayerOfFeatureType:GMSFeatureTypeLocality];

Проверьте возможности карты

Для создания стилей границ на основе данных необходимы возможности, включенные в консоли Google Cloud и связанные с идентификатором карты. Поскольку идентификаторы карт могут меняться, вы можете вызвать метод mapView.mapCapabilities для объекта GMSMapView , чтобы проверить, доступна ли определенная возможность (например, создание стилей на основе данных) перед ее вызовом.

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

Быстрый

class SampleViewController: UIViewController {

  private lazy var mapView: GMSMapView = GMSMapView(frame: .zero, mapID: GMSMapID(identifier: "YOUR_MAP_ID"), camera: GMSCameraPosition(latitude: 40, longitude: -80, zoom: 7))

  override func loadView() {
    self.view = mapView
    mapView.delegate = self
  }
}

extension SampleViewController: GMSMapViewDelegate {
  func mapView(_ mapView: GMSMapView, didChange mapCapabilities: GMSMapCapabilityFlags) {
    if (!mapCapabilities.contains(.dataDrivenStyling)) {
      // Data-driven styling is *not* available, add a fallback.
      // Existing feature layers are also unavailable.
    }
  }
}

Objective-C

@interface SampleViewController: UIViewController <GMSMapViewDelegate>
@end

@implementation SampleViewController
- (void)loadView {
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:[GMSMapID mapIDWithIdentifier:@"MAP_ID"] camera:[GMSCameraPosition cameraWithLatitude:40 longitude:-80 zoom:7]];
  mapView.delegete = self;
  self.view = mapView;
}

- (void)mapView:(GMSMapView *)mapView didChangeMapCapabilities:(GMSMapCapabilityFlags)mapCapabilities {
  if (!(mapCapabilities & GMSMapCapabilityFlagsDataDrivenStyling)) {
    // Data-driven styling is *not* available, add a fallback.
    // Existing feature layers are also unavailable.
  }
}
@end