Pierwsze kroki

Wybierz platformę: Android iOS JavaScript

Aby używać stylów opartych na danych w przypadku granic, musisz utworzyć identyfikator mapy. Następnie musisz utworzyć nowy styl mapy, wybrać potrzebne warstwy funkcji granic i powiązać styl z identyfikatorem mapy.

Tworzenie identyfikatora mapy

mapID to niepowtarzalny identyfikator, który reprezentuje pojedynczą instancję Mapy Google. W konsoli Google Cloud możesz w dowolnym momencie utworzyć identyfikatory mapy i zaktualizować styl powiązany z identyfikatorem mapy.

Tworzenie nowego stylu mapy

Aby utworzyć nowy styl mapy, postępuj zgodnie z instrukcjami w sekcji Zarządzanie stylami mapy. Po zakończeniu powiąż styl z nowo utworzonym identyfikatorem mapy.

Eksperymentalne: tę funkcję można ustawić tylko w przypadku jasnych stylów mapy. Gdy połączysz jasny styl mapy, w którym ta funkcja jest włączona, z identyfikatorem mapy, włączone warstwy będą też dostępne w przypadku ciemnego stylu mapy.

Wybieranie warstw funkcji

W konsoli Google Cloud możesz wybrać, które warstwy funkcji mają być wyświetlane. Określa to, jakie rodzaje granic będą widoczne na mapie (np. miejscowości, stany itp.).

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

Zarządzanie warstwami funkcji

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

2. Jeśli pojawi się prośba, wybierz projekt.

3. Wybierz styl mapy.

4. Aby dodać lub usunąć warstwy, kliknij menu Warstwy funkcji.

5. Kliknij Zapisz , aby zapisać zmiany i udostępnić je na mapach.

Aktualizowanie kodu inicjowania mapy

Ten krok wymaga powiązania identyfikatora mapy ze stylem, w którym jest włączona co najmniej 1 warstwa 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 mapId: DEMO_MAP_ID. DEMO_MAP_ID jest przeznaczony tylko do testowania. Nie używaj DEMO_MAP_ID w środowisku produkcyjnym.

Dodawanie warstw funkcji do mapy

Aby uzyskać odniesienie do warstwy mapy na mapie, po zainicjowaniu mapy wywołaj mapView.featureLayer(of:):

Swift

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

Objective-C

GMSFeatureLayer *layer = [mapView featureLayerOfFeatureType:GMSFeatureTypeLocality];

Sprawdzanie możliwości mapy

Style oparte na danych w przypadku granic wymagają możliwości, które są włączone w konsoli Google Cloud i powiązane z identyfikatorem mapy. Identyfikatory mapy mogą się zmieniać, dlatego przed wywołaniem określonej funkcji (np. stylów opartych na danych) możesz wywołać mapView.mapCapabilities w GMSMapView, aby sprawdzić, czy jest ona dostępna.

Możesz też wykrywać zmiany w możliwościach mapy, subskrybując GMSViewDelegate. Ten przykład pokazuje, jak używać protokołu do sprawdzania wymagań dotyczących stylów opartych 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