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

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

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

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

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

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

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

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

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

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

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

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

2. Выберите проект, если будет предложено.

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

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

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

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

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

Быстрый

// 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))

Цель-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)

Цель-C

GMSFeatureLayer *layer = [mapView featureLayerOfFeatureType:GMSFeatureTypeLocality];

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

Стилизация границ на основе данных требует возможностей, которые включены в Google Cloud Console и связаны с идентификатором карты. Поскольку идентификаторы карт могут быть изменены, вы можете вызвать 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.
    }
  }
}

Цель-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