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 correlati alla mappa.

L'istanza della mappa dovrebbe essere creata 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 comporterà un'eccezione o un comportamento indefinito.

Funzioni pubbliche per i membri

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

Funzioni pubbliche dei membri statici

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

Proprietà

ID IBOutlet< GMSMapViewDelegate >delegato
 Delegato GMSMapView.
GMSCameraPositionvideocamera
 Controlla la fotocamera, che definisce l'orientamento della mappa.
GMSProjectionproiezione
 Restituisce un oggetto GMSProjection che puoi utilizzare per convertire tra coordinate sullo schermo e coordinate di latitudine/longitudine.
BOOLmyLocationEnabled
 Consente di stabilire se attivare o meno il punto La mia posizione e il cerchio di precisione.
Posizione CL * myLocation
 Se la funzione La mia posizione è attiva, mostra dove è tracciato il pallino della posizione del dispositivo.
GMSMarkerselectedMarker
 L'indicatore selezionato.
BOOLtrafficEnabled
 Controlla se la mappa sta tracciando 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 (il punto massimo in cui la fotocamera può essere ridotta).
float maxZoom
 Zoom massimo (la fotocamera più vicina alla Terra).
BOOLbuildingsEnabled
 Se questa preferenza è impostata, gli edifici in 3D verranno mostrati se disponibili.
BOOLindoorEnabled
 Consente di impostare se visualizzare o meno le mappe di interni, ove disponibili.
GMSIndoorDisplayindoorDisplay
 riceve l'istanza GMSIndoorDisplay, che consente di osservare o controllare aspetti della visualizzazione dei dati in ambienti interni.
GMSUISettingsimpostazioni
 Recupera l'oggetto GMSUISettings, che controlla le impostazioni dell'interfaccia utente per la mappa.
UIEdgeInsetspaziatura interna
 Controlla l'area "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
 Consente di controllare la frequenza fotogrammi del rendering.
GMSCoordinateBoundscameraTargetBounds
 Se non è nullo, vincola l'obiettivo della fotocamera in modo che i gesti non lo facciano uscire dai limiti specificati.
GMSMapCapabilityFlagsmapCapabilities
 Tutte le funzionalità disponibili in modo condizionale (dipendenti dal mapID o da altre impostazioni della mappa) disponibili al momento.

Tieni presente che non si tratta di funzioni membri.

NSString *constkGMSAccessibilityCompass
 Identificatore di accessibilità per il pulsante 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 specificate.

Il valore dell'oggetto opzioni viene copiato con questo metodo.

- (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 obiettivo 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

Comunica a questa mappa di potenziare il renderer.

Questa operazione è facoltativa 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.

Questa operazione è facoltativa 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 al suolo.

Il punto della posizione visibile non verrà cancellato, né il mapType corrente verrà reimpostato.

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

Imposta minZoom e maxZoom.

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

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

Crea un valore GMSCameraPosition che presenti bounds con padding.

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

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

- (void) moveFotocamera: (GMSCameraUpdate *) aggiornamento

Cambia la videocamera in base a update.

Il cambio della fotocamera è istantaneo (senza animazione).

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

Controlla se le posizioni della videocamera specificate potrebbero causare la stessa visualizzazione, tenendo conto del livello di precisione e delle trasformazioni utilizzati internamente.

Restituisce un livello di caratteristiche del tipo specificato.

I livelli delle funzionalità devono essere configurati nella console Cloud.

Se un livello del tipo specificato non esiste su questa mappa, 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à ad alcuna chiamata.

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

- (void) animateToCameraPosition: (GMSCameraPosition *) cameraPosition

Anima la fotocamera di questa mappa in cameraPosition.

- (void) animateToLocation: (CLLocationCoordinate2D)  località

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

- (void) animateToZoom: (float)  zoom

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

Questo valore è limitato da [kGMSMinZoomLevel, kGMSMaxZoomLevel].

- (void) animateToBearing: (CLLocationDirection) cuscinetto

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

Zero indica il nord reale.

- (void) animateToViewingAngle: (doppio) viewingAngle

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

Questo valore sarà fissato a un minimo di zero (ossia rivolto verso il basso) e a una distanza compresa 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 animatoToFotocameraPosition:.


- (NSString* const) kGMSAccessibilityCompass [related]

Identificatore di accessibilità per il pulsante 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*) fotocamera [read, write, copy]

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

La modifica di questa proprietà è istantanea.

- (GMSProjection*) proiezione [read, assign]

Restituisce un oggetto GMSProjection che puoi utilizzare per convertire tra coordinate sullo schermo e 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, nel caso in cui la fotocamera sia stata impostata esplicitamente o la mappa appena creata, il frame successivo. Non sarà mai nulla.

- (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 è 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 utilizzando KVO.

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

L'indicatore selezionato.

L'impostazione di questa proprietà comporta la selezione di un determinato indicatore, che mostra una finestra informativa. Se questa proprietà non è null, l'impostazione su zero deseleziona l'indicatore, nascondendo la finestra informativa. Questa proprietà è osservabile utilizzando KVO.

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

Controlla se la mappa sta tracciando 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 mapStyle non nullo viene applicato solo se mapType è Normal.

- (mobile) minZoom [read, assign]

Zoom minimo (il punto massimo in cui la fotocamera può essere ridotta).

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

- (mobile) maxZoom [read, assign]

Zoom massimo (la fotocamera più vicina alla Terra).

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

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

Se questa preferenza è impostata, gli edifici in 3D verranno mostrati se disponibili.

Il valore predefinito è SÌ.

Questo può essere utile quando aggiungi un livello di riquadro personalizzato alla mappa, per renderlo più chiaro a livelli di zoom elevati. Se modifichi questo valore, tutti i riquadri verranno invalidati brevemente.

- (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 potrebbero essere eliminate definitivamente e qualsiasi piano attualmente selezionato dall'utente finale potrebbe essere reimpostato.

- (GMSIndoorDisplay*) indoorDisplay [read, assign]

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

- (GMSUISettings*) impostazioni [read, assign]

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

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

Controlla l'area "visibile" della vista.

Applicando la spaziatura interna, è possibile creare un'area attorno al bordo della vista che conterrà i dati della mappa ma non i controlli UI.

Se la spaziatura interna non è bilanciata, il centro visivo della visualizzazione si sposterà in base alle necessità. La spaziatura interna influirà anche sulla proprietà projection, pertanto la regione visibile non includerà l'area della spaziatura interna. GMSCameraUpdate fitToBounds fa in modo che vengano presi in considerazione sia questa spaziatura interna sia quella richiesta.

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 i controlli della mappa di posizione come la bussola, il pulsante della mia posizione e il selettore del piano all'interno dell'area di sicurezza del dispositivo.

Il valore predefinito è kGMSMapViewPaddingBehaviorBehavior Always.

- (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 per 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]

Consente di controllare la frequenza fotogrammi del rendering.

Il valore predefinito è kGMSFrameRateClose.

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

Se non è nullo, vincola l'obiettivo della fotocamera in modo che i gesti non lo facciano uscire dai limiti specificati.

Tutte le funzionalità disponibili in modo condizionale (dipendenti dal mapID o da altre impostazioni della mappa) disponibili al momento.

Non include funzionalità sempre disponibili.