Pierwsze kroki

Wybierz platformę: iOS JavaScript

Aby używać stylu opartego na danych dla granic, musisz utworzyć identyfikator mapy. Następnie musisz utworzyć nowy styl mapy, wybrać wymagane warstwy obiektów granicy i powiązać styl z identyfikatorem mapy.

Utwórz identyfikator mapy

mapID to unikalny identyfikator, który reprezentuje pojedynczą instancję Map Google. W każdej chwili możesz utworzyć identyfikator mapy i zaktualizować styl powiązany z identyfikatorem mapy.

Tworzenie nowego stylu mapy

Jeśli chcesz utworzyć nowy styl mapy, wykonaj instrukcje podane w artykule Zarządzanie stylami mapy. Po zakończeniu powiąż styl z nowo utworzonym identyfikatorem mapy.

Wybierz warstwy cech

W konsoli Google Cloud możesz wybrać, które warstwy cech chcesz wyświetlić. Określa rodzaj granic pojawiających się na mapie (np. rejony, stany itd.).

Ważne: aby uzyskać optymalną wydajność, wybierz tylko te warstwy, których potrzebujesz.

Zarządzanie warstwami cech

1. W konsoli Google Cloud otwórz stronę Style mapy.

2. W razie potrzeby wybierz projekt.

3. Wybierz styl mapy.

4. Kliknij menu Warstwy cech, aby dodać lub usunąć warstwy.

5. Aby zapisać zmiany i udostępnić je na mapach, kliknij Zapisz.

Zaktualizuj kod inicjowania mapy

Ten krok wymaga powiązania identyfikatora mapy ze stylem z włączoną co najmniej jedną warstwą funkcji. Aby sprawdzić, czy identyfikator mapy jest prawidłowo skonfigurowany w konsoli Cloud, sprawdź jego konfigurację w sekcji Zarządzanie Mapami.

Swift

// 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]];

Ważne: na potrzeby testowania możesz pominąć krok tworzenia i konfigurowania identyfikatora mapy, używając w kodzie aplikacji identyfikatora mapy: DEMO_MAP_ID. Funkcja DEMO_MAP_ID jest przeznaczona tylko do testów. Nie używaj DEMO_MAP_ID w środowisku produkcyjnym.

Dodawanie warstw cech do mapy

Aby uzyskać odniesienie do warstwy cech na mapie, wywołaj metodę mapView.featureLayer(of:) podczas inicjowania mapy:

Swift

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

Objective-C

GMSFeatureLayer *layer = [mapView featureLayerOfFeatureType:GMSFeatureTypeLocality];

Sprawdzanie możliwości mapy

Styl granic oparty na danych wymaga funkcji, które są włączone w konsoli Google Cloud i powiązane z identyfikatorem mapy. Identyfikatory map mogą się zmieniać, dlatego przed wywołaniem możesz wywołać metodę mapView.mapCapabilities w komponencie GMSMapView, aby sprawdzić, czy jest dostępna konkretna możliwość (np. styl oparty na danych).

Zmiany w możliwościach map możesz też wykrywać, subskrybując GMSViewDelegate. Ten przykład pokazuje, jak za pomocą protokołu sprawdzić wymagania dotyczące stylu opartego na danych.

Swift

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