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. | |
GMSCameraPosition * | videocamera |
Controlla la fotocamera, che definisce l'orientamento della mappa. | |
GMSProjection * | proiezione |
Restituisce un oggetto GMSProjection che puoi utilizzare per convertire tra coordinate sullo schermo e coordinate di latitudine/longitudine. | |
BOOL | myLocationEnabled |
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. | |
GMSMarker * | selectedMarker |
L'indicatore selezionato. | |
BOOL | trafficEnabled |
Controlla se la mappa sta tracciando dati sul traffico, se disponibili. | |
GMSMapViewType | mapType |
Controlla il tipo di riquadri della mappa da visualizzare. | |
GMSMapStyle * | mapStyle |
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). | |
BOOL | buildingsEnabled |
Se questa preferenza è impostata, gli edifici in 3D verranno mostrati se disponibili. | |
BOOL | indoorEnabled |
Consente di impostare se visualizzare o meno le mappe di interni, ove disponibili. | |
GMSIndoorDisplay * | indoorDisplay |
riceve l'istanza GMSIndoorDisplay, che consente di osservare o controllare aspetti della visualizzazione dei dati in ambienti interni. | |
GMSUISettings * | impostazioni |
Recupera l'oggetto GMSUISettings, che controlla le impostazioni dell'interfaccia utente per la mappa. | |
UIEdgeInset | spaziatura interna |
Controlla l'area "visibile" della vista. | |
GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
Controlla in che modo i riquadri dell'area di sicurezza vengono aggiunti ai valori di spaziatura interna. | |
BOOL | accessibilityElementsHidden |
Il valore predefinito è SÌ. | |
GMSMapLayer * | livello |
Funzione di accesso per il tipo CAlayer personalizzato utilizzato per il livello. | |
GMSFrameRate | preferredFrameRate |
Consente di controllare la frequenza fotogrammi del rendering. | |
GMSCoordinateBounds * | cameraTargetBounds |
Se non è nullo, vincola l'obiettivo della fotocamera in modo che i gesti non lo facciano uscire dai limiti specificati. | |
GMSMapCapabilityFlags | mapCapabilities |
Tutte le funzionalità disponibili in modo condizionale (dipendenti dal mapID o da altre impostazioni della mappa) disponibili al momento. | |
Funzioni correlate | |
Tieni presente che non si tratta di funzioni membri. | |
NSString *const | kGMSAccessibilityCompass |
Identificatore di accessibilità per il pulsante bussola. | |
NSString *const | kGMSAccessibilityMyLocation |
Identificatore di accessibilità per il pulsante "La mia posizione". | |
NSString *const | kGMSAccessibilityOutOfQuota |
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.
- (GMSFeatureLayer<GMSPlaceFeature *> *) feature LayerOfFeatureType: | (GMSFeatureType) | featureType |
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:.
Documentazione su amici e funzioni correlate
- (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.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
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.
- (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
Tutte le funzionalità disponibili in modo condizionale (dipendenti dal mapID o da altre impostazioni della mappa) disponibili al momento.
Non include funzionalità sempre disponibili.