Riferimento per la classe GMSMapView


Panoramica

Questa è la classe principale dell'SDK di Google Maps per iOS ed è il punto di accesso per tutti i metodi relativi alla mappa.

È necessario creare un'istanza della mappa tramite uno dei costruttori -init o -initWithOptions:.

GMSMapView può essere letto e modificato solo dal thread principale, come per tutti gli oggetti UIKit. La chiamata di questi metodi da un altro thread genererà un'eccezione o un comportamento non definito.

Funzioni pubbliche dei membri

(instancetype)- init
 Inizializza con CGRectZero e con le opzioni predefinite.
(instancetype)- initWithOptions:
 Crea una nuova visualizzazione mappa con le opzioni date.
(instancetype)- initWithFrame:
(instancetype)- initWithCoder:
(instancetype)- initWithFrame:camera:
 Crea e restituisce una visualizzazione mappa, con un frame e un obiettivo della fotocamera.
(instancetype)- initWithFrame:mapID:camera:
 Crea e restituisce una visualizzazione mappa con un frame, un ID mappa e un target della fotocamera.
(void) - startRendering
 Indica a questa mappa di potenziare il renderer.
(void) - stopRendering
 Comunica a questa mappa di spegnere il renderer.
(void) - chiaro
 Cancella tutti i markup aggiunti alla mappa, inclusi indicatori, polilinee e overlay del suolo.
(void) - setMinZoom:maxZoom:
 Imposta minZoom e maxZoom.
(nullable GMSCameraPosition *) - cameraForBounds:insets:
 Crea una GMSCameraPosition che presenti bounds con padding.
(void) - moveFotocamera:
 Cambia la videocamera in base alle update.
(BOOL) - areEqualForRenderingPosition:position:
 Controlla se le posizioni della videocamera indicate comporterebbero praticamente la stessa immagine, tenendo conto del livello di precisione e delle trasformazioni utilizzate internamente.
(GMSFeatureLayer
< GMSPlaceFeature * > *)
- featurelayerOfFeatureType:
 Restituisce un livello delle caratteristiche del tipo specificato.
(void) - animateToCameraPosition:
 Animazione della fotocamera di questa mappa su cameraPosition.
(void) - animateToLocation:
 Come animateToCameraPosition:, ma cambia solo la posizione della fotocamera (ad esempio, dalla posizione corrente a location).
(void) - animateToZoom:
 Come animateToCameraPosition:, ma modifica solo il livello di zoom della fotocamera.
(void) - animateToBearing:
 Come animateToCameraPosition:, ma cambia solo l'orientamento della fotocamera (in gradi).
(void) - animateToViewingAngle:
 Come animateToCameraPosition:, ma modifica solo l'angolo di visione della videocamera (in gradi).
(void) - animateWithFotocameraUpdate:
 Applica cameraUpdate alla fotocamera corrente, quindi utilizza il risultato come indicato da animateToCameraPosition:.

Funzioni membri pubbliche statiche

(instancetype)+ mapWithFrame:camera:
 Crea e restituisce una visualizzazione mappa con un frame e un obiettivo della fotocamera.
(instancetype)+ mapWithFrame:mapID:camera:
 Inizializzatore pratico per creare e restituire una visualizzazione mappa con un frame, un ID mappa e un target della fotocamera.

Proprietà

ID IBOutlet< GMSMapViewDelegate >delegato
 Delegato GMSMapView.
GMSCameraPositionfotocamera
 Controlla la fotocamera, che definisce l'orientamento della mappa.
GMSProjectionproiezione
 Restituisce un oggetto GMSProjection che puoi utilizzare per convertire le coordinate sullo schermo e le coordinate di latitudine/longitudine.
BOOLmyLocationEnabled
 Consente di stabilire se attivare o meno il punto La mia posizione e il cerchio di precisione.
CLLocation * myLocation
 Se la funzione La mia posizione è attiva, mostra dove viene tracciato il pallino della posizione del dispositivo.
GMSMarkerselectedMarker
 L'indicatore selezionato.
BOOLtrafficEnabled
 Consente di controllare se la mappa fornisce dati sul traffico, se disponibili.
GMSMapViewTypemapType
 Controlla il tipo di riquadri della mappa da visualizzare.
GMSMapStylemapStyle
 Controlla lo stile della mappa.
float minZoom
 Zoom minimo (l'estensione massima della fotocamera può essere ridotta).
float maxZoom
 Zoom massimo (il più vicino possibile la fotocamera alla Terra).
BOOLbuildingsEnabled
 Se impostato, gli edifici in 3D verranno mostrati, se disponibili.
BOOLindoorEnabled
 Consente di impostare se visualizzare o meno le mappe di interni, ove disponibili.
GMSIndoorDisplayindoorDisplay
 Ottieni l'istanza GMSIndoorDisplay, che consente di osservare o controllare aspetti della visualizzazione dei dati negli ambienti interni.
GMSUISettingsimpostazioni
 Ottiene l'oggetto GMSUISettings, che controlla le impostazioni dell'interfaccia utente per la mappa.
UIEdgeInsetsspaziatura interna
 Controlla la regione "visibile" della vista.
GMSMapViewPaddingAdjustmentBehaviorpaddingAdjustmentBehavior
 Controlla in che modo i riquadri dell'area di sicurezza vengono aggiunti ai valori di spaziatura interna.
BOOLaccessibilityElementsHidden
 Il valore predefinito è SÌ.
GMSMapLayerlivello
 Funzione di accesso per il tipo CAlayer personalizzato utilizzato per il livello.
GMSFrameRatepreferredFrameRate
 Controlla la frequenza fotogrammi del rendering.
GMSCoordinateBoundscameraTargetBounds
 Se non è nullo, vincola l'obiettivo della fotocamera in modo che i gesti non possano causare l'uscita dai limiti specificati.
GMSMapCapabilityFlagsmapCapabilities
 Tutte le funzionalità disponibili in base a condizioni (dipendenti da mapID o da altre impostazioni della mappa) disponibili al momento.

Tieni presente che non si tratta di funzioni membro.

NSString *constkGMSAccessibilityCompass
 Identificatore di accessibilità per il pulsante della bussola.
NSString *constkGMSAccessibilityMyLocation
 Identificatore di accessibilità per il pulsante "La mia posizione".
NSString *constkGMSAccessibilityOutOfQuota
 Identificatore di accessibilità per l'etichetta di errore "fuori quota".

Documentazione sulle funzioni membri

- (instancetype) init

Inizializza con CGRectZero e con le opzioni predefinite.

- (instancetype) initWithOptions: (nonnull GMSMapViewOptions *) opzioni

Crea una nuova visualizzazione mappa con le opzioni date.

Questo metodo copia il valore dell'oggetto opzioni.

- (instancetype) initWithFrame: (CGRect) frame
- (instancetype) initWithCoder: (NSCoder *) programmatore
+ (instancetype) mapWithFrame: (CGRect) frame
videocamera: (GMSCameraPosition *) videocamera

Crea e restituisce una visualizzazione mappa con un frame e un obiettivo della fotocamera.

+ (instancetype) mapWithFrame: (CGRect) frame
ID mappa: (GMSMapID *) mapID
videocamera: (GMSCameraPosition *) videocamera

Inizializzatore pratico per creare e restituire una visualizzazione mappa con un frame, un ID mappa e un target della fotocamera.

- (instancetype) initWithFrame: (CGRect) frame
videocamera: (GMSCameraPosition *) videocamera

Crea e restituisce una visualizzazione mappa, con un frame e un obiettivo della fotocamera.

Nota:
Questa opzione è deprecata. Usa invece -init o -initWithOptions:.
- (instancetype) initWithFrame: (CGRect) frame
ID mappa: (GMSMapID *) mapID
videocamera: (GMSCameraPosition *) videocamera

Crea e restituisce una visualizzazione mappa con un frame, un ID mappa e un target della fotocamera.

Nota:
Questa opzione è deprecata. Usa invece -init o -initWithOptions:.
- (void) startRendering

Indica a questa mappa di potenziare il renderer.

È facoltativo e idempotente.

Nota:
Questa opzione è deprecata. Questo metodo è obsoleto e verrà rimosso in una release futura.
- (void) stopRendering

Comunica a questa mappa di spegnere il renderer.

È facoltativo e idempotente.

Nota:
Questa opzione è deprecata. Questo metodo è obsoleto e verrà rimosso in una release futura.
- (void) clear

Cancella tutti i markup aggiunti alla mappa, inclusi indicatori, polilinee e overlay del suolo.

Il pallino della posizione visibile non verrà cancellato né resettato il mapType corrente.

- (void) setMinZoom: (float)  minZoom
maxZoom: (float)  maxZoom

Imposta minZoom e maxZoom.

Questo metodo prevede che il valore minimo sia inferiore o uguale al massimo e, in caso contrario, genererà un'eccezione denominata NSRangeException.

- (nullable GMSCameraPosition *) cameraForBounds: (GMSCoordinateBounds *) limiti
inserti: (UIEdgeInset) inset

Crea una GMSCameraPosition che presenti bounds con padding.

La videocamera avrà un raggio di orientamento e un'inclinazione pari a zero (ovvero rivolta verso nord e guarda direttamente verso la Terra). In questo modo vengono presi in considerazione il frame e la spaziatura interna di GMSMapView.

Se i limiti non sono validi, questo metodo restituirà zero fotocamera.

- (void) moveFotocamera: (GMSCameraUpdate *) aggiornamento

Cambia la videocamera in base alle update.

Il cambio della fotocamera è istantaneo (senza animazione).

- (BOOL) areEqualForRenderingPosition: (GMSCameraPosition *) position
posizione: (GMSCameraPosition *) otherPosition

Controlla se le posizioni della videocamera indicate comporterebbero praticamente la stessa immagine, tenendo conto del livello di precisione e delle trasformazioni utilizzate internamente.

Restituisce un livello delle caratteristiche del tipo specificato.

I livelli delle caratteristiche devono essere configurati nella console Cloud.

Se un livello del tipo specificato non esiste su questa mappa o se gli stili basati sui dati non sono attivati o se il framework di rendering Metal non viene utilizzato, il valore isAvailable del livello risultante sarà NO e non risponderà a nessuna chiamata.

Richiede il renderer Metal. Scopri come abilitare Metal alla pagina https://developers.google.com/maps/documentation/ios-sdk/config#use-metal

- (void) animateToCameraPosition: (GMSCameraPosition *) cameraPosition

Animazione della fotocamera di questa mappa su cameraPosition.

- (void) animateToLocation: (CLLocationCoordinate2D)  località

Come animateToCameraPosition:, ma cambia solo la posizione della fotocamera (ad esempio, dalla posizione corrente a location).

- (void) animateToZoom: (float)  zoom

Come animateToCameraPosition:, ma modifica solo il livello di zoom della fotocamera.

Questo valore è limitato da [kGMSMinZoomLevel, kGMSMaxZoomLevel].

- (void) animateToBearing: (CLLocationDirection) cuscinetto

Come animateToCameraPosition:, ma cambia solo l'orientamento della fotocamera (in gradi).

Zero indica il nord vero.

- (void) animateToViewingAngle: (doppio) viewingAngle

Come animateToCameraPosition:, ma modifica solo l'angolo di visione della videocamera (in gradi).

Questo valore sarà fissato a un minimo di zero (cioè rivolto verso il basso) e tra 30 e 45 gradi verso l'orizzonte, a seconda della relativa vicinanza alla terra.

- (void) animateWithFotocameraUpdate: (GMSCameraUpdate *) cameraUpdate

Applica cameraUpdate alla fotocamera corrente, quindi utilizza il risultato come indicato da animateToCameraPosition:.


- (NSString* const) kGMSAccessibilityCompass [related]

Identificatore di accessibilità per il pulsante della bussola.

- (NSString* const) kGMSAccessibilityMyLocation [related]

Identificatore di accessibilità per il pulsante "La mia posizione".

- (NSString* const) kGMSAccessibilityOutOfQuota [related]

Identificatore di accessibilità per l'etichetta di errore "fuori quota".


Documentazione della proprietà

- (ID IBOutlet<GMSMapViewDelegate>) delegato [read, write, assign]

Delegato GMSMapView.

- (GMSCameraPosition*) camera [read, write, copy]

Controlla la fotocamera, che definisce l'orientamento della mappa.

La modifica di questa proprietà è istantanea.

- proiezione (GMSProjection*) [read, assign]

Restituisce un oggetto GMSProjection che puoi utilizzare per convertire le coordinate sullo schermo e le coordinate di latitudine/longitudine.

Questa è un'istantanea della proiezione corrente e non verrà aggiornata automaticamente quando la videocamera si muove. Rappresenta la proiezione dell'ultimo frame GMSMapView disegnato oppure, se la fotocamera è stata impostata esplicitamente o la mappa appena creata, il frame successivo. Non sarà mai nullo.

- (BOOL) myLocationEnabled [read, write, assign]

Consente di stabilire se attivare o meno il punto La mia posizione e il cerchio di precisione.

Il valore predefinito è NO.

- (CLLocation*) myLocation [read, assign]

Se la funzione La mia posizione è attiva, mostra dove viene tracciato il pallino della posizione del dispositivo.

Se l'opzione è disattivata o se è attiva ma non sono disponibili dati sulla posizione, il valore sarà nullo. Questa proprietà è osservabile tramite KVO.

- (GMSMarker*) selectedMarker [read, write, assign]

L'indicatore selezionato.

L'impostazione di questa proprietà seleziona un determinato indicatore, che mostra una finestra informativa. Se questa proprietà è diversa da null, l'impostazione su null deseleziona l'indicatore, nascondendo la finestra informativa. Questa proprietà è osservabile tramite KVO.

- (BOOL) trafficEnabled [read, write, assign]

Consente di controllare se la mappa fornisce dati sul traffico, se disponibili.

Ciò è soggetto alla disponibilità dei dati sul traffico. Il valore predefinito è NO.

- (GMSMapViewType) mapType [read, write, assign]

Controlla il tipo di riquadri della mappa da visualizzare.

Il valore predefinito è kGMSTypeNormal.

- (GMSMapStyle*) mapStyle [read, write, assign]

Controlla lo stile della mappa.

Un elemento mapStyle non nullo viene applicato solo se mapType è impostato su Normal.

- (float) minZoom [read, assign]

Zoom minimo (l'estensione massima della fotocamera può essere ridotta).

Il valore predefinito è kGMSMinZoomLevel. Modificato con -setMinZoom:maxZoom:.

- (float) maxZoom [read, assign]

Zoom massimo (il più vicino possibile la fotocamera alla Terra).

Il valore predefinito è kGMSMaxZoomLevel. Modificato con -setMinZoom:maxZoom:.

- (BOOL) buildingsEnabled [read, write, assign]

Se impostato, gli edifici in 3D verranno mostrati, se disponibili.

Il valore predefinito è SÌ.

Ciò può essere utile quando si aggiunge un livello di riquadro personalizzato alla mappa, per renderla più chiara a livelli di zoom elevati. La modifica di questo valore causerà la validità temporanea di tutti i riquadri.

- (BOOL) indoorEnabled [read, write, assign]

Consente di impostare se visualizzare o meno le mappe di interni, ove disponibili.

Il valore predefinito è SÌ.

Se viene impostato su NO, le cache per i dati degli interni possono essere eliminate definitivamente e qualsiasi piano attualmente selezionato dall'utente finale può essere reimpostato.

- (GMSIndoorDisplay*) indoorDisplay [read, assign]

Ottieni l'istanza GMSIndoorDisplay, che consente di osservare o controllare aspetti della visualizzazione dei dati negli ambienti interni.

- (GMSUISettings*) impostazioni [read, assign]

Ottiene l'oggetto GMSUISettings, che controlla le impostazioni dell'interfaccia utente per la mappa.

- (UIEdgeInsets) Spaziatura interna [read, write, assign]

Controlla la regione "visibile" della vista.

Puoi creare una spaziatura interna in un'area attorno al bordo della vista che conterrà i dati della mappa ma non i controlli dell'interfaccia utente.

Se la spaziatura interna non è bilanciata, il centro visivo della visualizzazione verrà spostato in base alle esigenze. La spaziatura interna influirà anche sulla proprietà projection, pertanto la regione visibile non includerà l'area. GMSCameraUpdate fitToBounds farà in modo che questa spaziatura interna e l'eventuale spaziatura interna richiesta vengano prese in considerazione.

Questa proprietà può essere animata in un blocco di animazione basato su UIView.

Controlla in che modo i riquadri dell'area di sicurezza vengono aggiunti ai valori di spaziatura interna.

Come la spaziatura interna, l'area di sicurezza inserisce controlli della mappa della posizione come la bussola, il pulsante La mia posizione e il selettore del piano all'interno dell'area di sicurezza del dispositivo.

Il valore predefinito è kGMSMapViewPaddingAdjustBehaviorsempre.

- (BOOL) accessibilityElementsHidden [read, write, assign]

Il valore predefinito è SÌ.

Se impostato su NO, GMSMapView genererà elementi di accessibilità per gli oggetti in overlay, come GMSMarker e GMSPolyline.

Questa proprietà segue il protocollo informale UIAccessibility, tranne il valore predefinito YES.

- (GMSMapLayer*) livello [read, retain]

Funzione di accesso per il tipo CAlayer personalizzato utilizzato per il livello.

- (GMSFrameRate) preferredFrameRate [read, write, assign]

Controlla la frequenza fotogrammi del rendering.

Il valore predefinito è kGMSFrameRatemaximum.

- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign]

Se non è nullo, vincola l'obiettivo della fotocamera in modo che i gesti non possano causare l'uscita dai limiti specificati.

Tutte le funzionalità disponibili in base a condizioni (dipendenti da mapID o da altre impostazioni della mappa) disponibili al momento.

Non include funzionalità sempre disponibili.