Configurare una mappa

Seleziona la piattaforma: Android iOS

Questa panoramica descrive come configurare una mappa aggiunta a un'app per iOS utilizzando Maps SDK for iOS.

Panoramica

Dopo aver aggiunto una mappa alla tua app, puoi configurare le opzioni iniziali e le impostazioni di runtime della mappa. Per informazioni dettagliate sull'aggiunta di un contenitore di mappe, consulta Aggiungi una mappa.

Le impostazioni iniziali della mappa includono:

• La posizione della videocamera, tra cui: posizione, zoom, orientamento e inclinazione. Per informazioni dettagliate sul posizionamento della videocamera, consulta Videocamera e visualizzazione.
• Il colore di sfondo della mappa.
• Il tipo di mappa.
• I componenti UI da visualizzare, come i pulsanti di zoom e la bussola.
• I gesti da attivare.

In fase di runtime puoi configurare queste impostazioni e alcune impostazioni aggiuntive aggiornando l'oggetto GMSMapView.

Opzioni della mappa

Durante l'inizializzazione della visualizzazione mappa, le opzioni di configurazione vengono impostate con GMSMapViewOptions. Le proprietà delle opzioni includono frame, camera, mapID o backgroundColor.

Opzioni mappa
cornice	Valore: CGRect Il frame della mappa. Il valore predefinito è CGRectZero.
fotocamera	Valore: GMSCameraPosition La posizione predefinita della videocamera della mappa.
mapID	Valore: GMSMapID ID mappa Google. Parametro facoltativo.
backgroundColor	Valore: UIColor Il valore predefinito è UIColor.lightGray

Configura le opzioni della mappa

Puoi impostare le proprietà delle opzioni o passare un'istanza di GMSMapViewOptions con valori predefiniti direttamente a GMSMapView.

Swift

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Ecco un esempio di passaggio di un oggetto GMSMapViewOptions con valori predefiniti direttamente a GMSMapView.

Swift

let options = GMSMapViewOptions()
let mapView = GMSMapView(options:options) //initialized with default values

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options]; //initialized with default values

Configura il colore di sfondo

Quando lavori in modalità Buio o passi da una visualizzazione mappa all'altra, potrebbe essere utile eseguire l'override del colore di sfondo predefinito della mappa. Per farlo, imposta la proprietà backgroundColor delle opzioni della mappa.

Swift

let options = GMSMapViewOptions()
options.backgroundColor = UIColor.yellowColor
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.backgroundColor = UIColor.yellowColor;
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Nota: puoi anche utilizzare la personalizzazione delle mappe basata su cloud per configurare il colore di sfondo. Il colore di sfondo impostato nello stile di mappa ha una priorità maggiore rispetto al colore di sfondo locale. Per saperne di più, consulta Modifica il colore di sfondo dell'app per la personalizzazione delle mappe basata su cloud.

Tipi di mappe

Puoi personalizzare la mappa con uno dei diversi tipi di mappa. Il tipo di mappa determina la rappresentazione complessiva della mappa. Ad esempio, un atlante di solito contiene mappe politiche che si concentrano sulla visualizzazione dei confini e mappe stradali che mostrano tutte le strade di una città o di una regione. Maps SDK for iOS offre i seguenti tipi di mappe:

Tipo di mappa
Normale	Valore: kGMSTypeNormal Tipica mappa stradale. Mostra le strade, alcuni elementi costruiti dall'uomo e importanti elementi naturali come i fiumi. Sono visibili anche le etichette delle strade e degli elementi. Supporta l'impostazione della combinazione di colori della mappa su scuro, chiaro o in base alle impostazioni di sistema.
Ibrido	Valore: kGMSTypeHybrid Dati fotografici satellitari con l'aggiunta di mappe stradali. Sono visibili anche le etichette delle strade e degli elementi.
Satellite	Valore: kGMSTypeSatellite Dati delle fotografie satellitari. Le etichette delle strade e degli elementi non sono visibili.
Rilievo	Valore: kGMSTypeTerrain Dati topografici. La mappa include colori, linee di contorno ed etichette, nonché ombreggiatura prospettica. Sono visibili anche alcune strade ed etichette. Supporta l'impostazione della combinazione di colori della mappa su scuro, chiaro o in base alle impostazioni di sistema.
Nessuno	Valore: kGMSTypeNone Nessun riquadro della mappa. I riquadri della mappa base non verranno visualizzati. Questa modalità è utile in combinazione con i livelli di riquadri. La visualizzazione dei dati sul traffico è disattivata quando il tipo di mappa è impostato su Nessuno.

Modifica il tipo di mappa

Per impostare il tipo di mappa, assegna un nuovo valore alla proprietà GMSMapView.mapType. Ad esempio, per visualizzare un tipo di mappa satellitare:

Swift

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)
mapView.mapType = .satellite

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                  longitude:151.2086
                                                        zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
mapView.mapType = kGMSTypeSatellite;

Il selettore di seguito mostra un confronto tra mappe di rilievo, normali e ibride per la stessa località:

Mappe di interni

A livelli di zoom elevati, Maps SDK for iOS mostra le planimetrie di spazi interni come aeroporti, centri commerciali, grandi negozi di vendita al dettaglio e stazioni di transito. Le planimetrie degli interni sono integrate nei riquadri della mappa predefinita per il tipo di mappa "normale" (kGMSTypeNormal) e vengono attivate automaticamente quando l'utente aumenta lo zoom e svaniscono quando lo zoom viene diminuito.

Puoi disattivare le mappe di interni impostando la proprietà indoorEnabled di GMSMapView su NO.

Swift

mapView.isIndoorEnabled = false
      

Objective-C

mapView.indoorEnabled = NO;
      

In alternativa, puoi disattivare solo il controllo del selettore di piano.

Aggiungi planimetrie

Le piantine sono disponibili in alcune località. Se i dati della planimetria non sono disponibili per un edificio che vuoi mettere in evidenza nella tua applicazione, puoi:

• Aggiungi le planimetrie direttamente su Google Maps. In questo modo, i tuoi piani saranno disponibili per tutti gli utenti di Google Maps.
• Visualizza una planimetria come overlay del terreno. In questo modo, solo gli utenti della tua applicazione possono visualizzare le planimetrie.

Il livello traffico

Puoi offrire agli utenti la possibilità di visualizzare la mappa con le informazioni sulla densità del traffico sovrapposte. In questo modo, gli utenti possono visualizzare un riepilogo visivo della situazione del traffico locale. Puoi attivare e disattivare il livello del traffico chiamando il metodo trafficEnabled. L'esempio seguente mostra come potrebbe apparire il livello del traffico su una mappa.

Il livello Trasporto pubblico

Maps SDK for iOS ti consente di visualizzare la rete di trasporto pubblico di una città sulla mappa utilizzando il metodo transitEnabled. Quando il livello Traffico è attivo e la mappa è centrata su una città che supporta le informazioni sul trasporto pubblico, la mappa mostra le principali linee di trasporto pubblico come linee spesse e colorate. Il colore della linea viene impostato in base alle informazioni fornite dall'operatore della linea di trasporto pubblico. L'attivazione del livello Trasporto pubblico modifica lo stile della mappa base per mettere in evidenza i percorsi del trasporto pubblico.

Se rappresenti un ente pubblico che supervisiona il trasporto pubblico della tua città e vuoi che i tuoi dati vengano inclusi, visita il sito del Programma Partner di Google Transit per saperne di più.

L'esempio seguente mostra come potrebbe apparire il livello Trasporto pubblico su una mappa.

Accessibilità

Per impostazione predefinita, gli elementi di accessibilità sulla mappa sono nascosti. Puoi attivare l'accessibilità impostando la proprietà accessibilityElementsHidden di GMSMapView su NO. In questo modo, vengono generati elementi di accessibilità per gli oggetti overlay (come GMSMarker e finestre informative, GMSPolyline e così via).

Swift

mapView.accessibilityElementsHidden = false
      

Objective-C

mapView.accessibilityElementsHidden = NO;
      

Questa proprietà è conforme al protocollo informale UIAccessibility, ad eccezione del fatto che il valore predefinito in Maps SDK for iOS è YES.

La mia posizione

Per impostazione predefinita, sulla mappa non vengono mostrati dati sulla posizione. Puoi attivare il punto blu "La mia posizione" e la direzione della bussola impostando myLocationEnabled su GMSMapView.

Swift

mapView.isMyLocationEnabled = true
      

Objective-C

mapView.myLocationEnabled = YES;
      

L'attivazione di questa funzionalità fornisce la posizione attuale dell'utente tramite la proprietà myLocation. Questa proprietà potrebbe non essere immediatamente disponibile, ad esempio se iOS chiede all'utente di consentire l'accesso a questi dati. In questo caso è nil.

Swift

print("User's location: \(String(describing: mapView.myLocation))")
      

Objective-C

NSLog(@"User's location: %@", mapView.myLocation);
      

Edifici 3D

In molte città, se visualizzate da vicino, sono visibili gli edifici in 3D, come mostrato nell'immagine di Seattle, Washington, di seguito.

Puoi disattivare gli edifici in 3D impostando la proprietà GMSMapView corrispondente in Swift o Objective-C, come mostrato di seguito:

Swift

mapView.isBuildingsEnabled = false
      

Objective-C

[mapView setBuildingsEnabled:NO];
      

Spaziatura interna della mappa

Una mappa Google è progettata per riempire l'intera regione definita da GMSMapView. Diversi aspetti dell'aspetto e del comportamento della mappa sono definiti dalle dimensioni della visualizzazione:

• Il target della videocamera riflette il centro della regione con spaziatura interna.
• I controlli della mappa sono posizionati rispetto ai bordi della mappa.
• Le informazioni legali, come le dichiarazioni sul copyright o il logo Google, vengono visualizzate lungo il bordo inferiore della mappa.

Puoi aggiungere spaziatura interna intorno ai bordi della mappa utilizzando GMSMapView.Proprietà padding. La mappa continua a riempire l'intero contenitore, ma il posizionamento del testo e dei controlli, i gesti sulla mappa e i movimenti della videocamera si comportano come se fosse stata posizionata in uno spazio più piccolo. Questo comporta le seguenti modifiche:

• I movimenti della fotocamera che utilizzano chiamate API o pressioni di pulsanti (ad es. bussola, la mia posizione) sono relativi alla regione con spaziatura interna.
• GMSMapView.projection restituisce una proiezione che include solo la regione con padding.
• I controlli UI sono spostati dal bordo del contenitore del numero di punti specificato.

La spaziatura interna può essere utile quando si progettano UI che si sovrappongono a una parte della mappa. Ad esempio, nell'immagine, la mappa è spaziatata lungo i bordi superiore e destro. I controlli della mappa visibili e il testo legale vengono visualizzati lungo i bordi della regione con spaziatura interna, mostrata in verde, mentre la mappa continua a riempire l'intero contenitore, mostrato in blu. In questo esempio, puoi far fluttuare un menu sul lato destro della mappa senza oscurare i controlli della mappa.

Per aggiungere spaziatura interna alla mappa, crea un oggetto UIEdgeInsets e passalo a GMSMapView.padding proprietà.

Swift

// Insets are specified in this order: top, left, bottom, right
let mapInsets = UIEdgeInsets(top: 100.0, left: 0.0, bottom: 0.0, right: 300.0)
mapView.padding = mapInsets
      

Objective-C

// Insets are specified in this order: top, left, bottom, right
UIEdgeInsets mapInsets = UIEdgeInsetsMake(100.0, 0.0, 0.0, 300.0);
mapView.padding = mapInsets;
      

Nota: come specificato nei Termini di servizio di Google Maps Platform, l'applicazione non deve rimuovere o oscurare il logo Google o le note sul copyright. La spaziatura interna della mappa ti consente di riposizionare questi elementi, se necessario. Se mostri una UI personalizzata nella parte inferiore della mappa, aggiungi spaziatura interna in questa posizione in modo che il logo e le note legali siano visibili.

Combinazione di colori della mappa

Per le mappe di tipo normale e terreno, puoi impostare la combinazione di colori della mappa su scura, chiara o in modo che utilizzi le impostazioni di sistema correnti. Ad esempio, puoi scurire o schiarire la combinazione di colori della mappa in base all'ora del giorno o all'utilizzo del dispositivo all'interno o all'esterno.

Utilizza GMSMapView overrideUserInterfaceStyle: per impostare e aggiornare la combinazione di colori della mappa.

Swift

let options = GMSMapViewOptions()
// Map is init to use light mode by default.
let mapView = GMSMapView(options: options)
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = .dark
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = .light
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = .unspecified

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
// Map is init to always use light mode.
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleDark;
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleLight;
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleUnspecified;

Per creare stili personalizzati per le mappe in modalità Luce e Scura, utilizza la personalizzazione delle mappe basata su cloud.