Iniziamo

Seleziona la piattaforma: iOS JavaScript

Per utilizzare gli stili basati sui dati per i confini, devi creare un ID mappa. Successivamente, devi creare un nuovo stile di mappa, selezionare i livelli degli elementi di confine necessari e associare lo stile al tuo ID mappa.

Crea un ID mappa

Un mapID è un identificatore univoco che rappresenta una singola istanza di una mappa di Google. Puoi creare ID mappa e aggiornare uno stile associato a un ID mappa in qualsiasi momento nella console Google Cloud.

Crea un nuovo stile di mappa

Per creare un nuovo stile di mappa, segui le istruzioni riportate in Gestire gli stili di mappa per creare lo stile. Al termine, associa lo stile all'ID mappa appena creato.

Seleziona livelli degli elementi

Nella console Google Cloud puoi selezionare i livelli delle funzionalità da visualizzare. Questo determina quali tipi di confini vengono visualizzati sulla mappa (ad esempio località, stati e così via).

Importante: per prestazioni ottimali, seleziona solo i livelli che ti servono.

Gestire i livelli degli elementi

1. Nella console Google Cloud, vai alla pagina Stili mappa.

2. Seleziona un progetto, se richiesto.

3. Seleziona uno stile di mappa.

4. Fai clic sul menu a discesa Livelli degli elementi per aggiungere o rimuovere livelli.

5. Fai clic su Salva per salvare le modifiche e renderle disponibili per le tue mappe.

Aggiorna il codice di inizializzazione della mappa

Questo passaggio richiede l'associazione di un ID mappa a uno stile con uno o più livelli di caratteristiche abilitati. Per verificare che l'ID mappa sia configurato correttamente nella console Cloud, controlla come è configurato in Gestione di Maps.

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

Importante: per i test, puoi saltare il passaggio della creazione e della configurazione di un ID mappa utilizzando mapId: DEMO_MAP_ID nel codice dell'app. DEMO_MAP_ID è destinato esclusivamente a scopi di test. Non utilizzare DEMO_MAP_ID in un ambiente di produzione.

Aggiungere livelli di elementi a una mappa

Per ottenere un riferimento a un livello di elementi sulla mappa, richiama mapView.featureLayer(of:) durante l'inizializzazione della mappa:

Swift

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

Objective-C

GMSFeatureLayer *layer = [mapView featureLayerOfFeatureType:GMSFeatureTypeLocality];

Verifica le funzionalità della mappa

Gli stili basati sui dati per i confini richiedono funzionalità abilitate in Google Cloud Console e associate a un ID mappa. Poiché gli ID mappa sono soggetti a modifiche, puoi chiamare mapView.mapCapabilities su un GMSMapView per verificare se è disponibile una determinata funzionalità (ad esempio gli stili basati sui dati) prima di chiamarla.

Puoi anche rilevare cambiamenti nelle funzionalità della mappa iscrivendoti a GMSViewDelegate. Questo esempio mostra come utilizzare il protocollo per verificare i requisiti di stile basato sui dati.

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