Panoramica
Questa è la classe principale di Google Maps SDK per iOS ed è il punto di accesso per tutti i metodi correlati alla mappa.
Deve essere creata un'istanza per la mappa con 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 indefinito.
Funzioni dei membri pubblici | |
| (instancetype) | - init |
| Inizializza con CGRectZero e le opzioni predefinite. | |
| (instancetype) | - initWithOptions: |
| Crea una nuova visualizzazione della mappa con le opzioni specificate. | |
| (instancetype) | - initWithFrame: |
| (tipo di istanza con valore nullo) | - initWithCoder: |
| (instancetype) | - initWithFrame:camera: |
| Crea e restituisce una visualizzazione mappa, con un frame e un obiettivo della videocamera. | |
| (instancetype) | - initWithFrame:mapID:camera: |
| Crea e restituisce una visualizzazione mappa con un frame, un ID mappa e un obiettivo della fotocamera. | |
| (void) | - startRendering |
| Indica alla mappa di potenziare il renderer. | |
| (void) | - stopRendering |
| Indica alla mappa di spegnere il renderer. | |
| (void) | - cancella |
| Cancella tutti i markup aggiunti alla mappa, compresi indicatori, polilinee e overlay al suolo. | |
| (void) | - setMinZoom:maxZoom: |
Imposta minZoom e maxZoom. | |
| (nullable GMSCameraPosition *) | - cameraForBounds:insets: |
Crea una GMSCameraPosition che presenti bounds con padding. | |
| (void) | - moveCamera: |
Modifica la fotocamera in base a update. | |
| (BOOL) | - areEqualForRenderingPosition:position: |
| Controlla se le posizioni date della videocamera potrebbero causare praticamente lo stesso rendering della videocamera, tenendo conto del livello di precisione e delle trasformazioni utilizzate internamente. | |
| (GMSFeatureLayer < GMSPlaceFeature * > *) | - featureLivelloOfFeatureType: |
| Restituisce un livello di caratteristiche del tipo specificato. | |
| (GMSDatasetFeatureLayer *) | - datasetFeaturelayerOfDatasetID: |
| Restituisce un livello delle caratteristiche del set di dati specificato. | |
| (void) | - animateToCameraPosition: |
Consente di avviare l'animazione della fotocamera di questa mappa fino a 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 modifica solo l'orientamento della fotocamera (in gradi). | |
| (void) | - animateToViewingAngle: |
| Come animateToCameraPosition:, ma modifica solo l'angolo di visualizzazione della fotocamera (in gradi). | |
| (void) | - animateWithCameraUpdate: |
Applica cameraUpdate alla fotocamera corrente e poi utilizza il risultato come animatoToCameraPosition:. | |
Funzioni membro pubbliche statiche | |
| (instancetype) | + mapWithFrame:camera: |
| Crea e restituisce una visualizzazione mappa con un frame e un obiettivo della fotocamera. | |
| (instancetype) | + mapWithFrame:mapID:camera: |
| Pratico inizializzatore 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 * | da 64 MP |
| Controlla la fotocamera, che definisce il modo in cui è orientata la mappa. | |
| GMSProjection * | proiezione |
| Restituisce un oggetto GMSProjection che puoi utilizzare per convertire le coordinate sullo schermo e le coordinate di latitudine/longitudine. | |
| BOOL | myLocationEnabled |
| Consente di stabilire se attivare o meno il punto e il cerchio di precisione La mia posizione. | |
| CLLocation * | myLocation |
| Se la funzionalità La mia posizione è attiva, mostra dove è stato tracciato il punto con la posizione del dispositivo. | |
| GMSMarker * | selectedMarker |
| L'indicatore selezionato. | |
| BOOL | trafficEnabled |
| Consente di stabilire se la mappa sta tracciando dati sul traffico, se disponibili. | |
| GMSMapViewType | mapType |
| Controlla il tipo di riquadri di mappa da visualizzare. | |
| GMSMapStyle * | mapStyle |
| Controlla lo stile della mappa. | |
| Stile interfaccia utente | overrideUserInterfaceStyle |
| Modifica la mappa impostandola sullo UIUserInterfaceStyle desiderato. | |
| float | minZoom |
| Zoom minimo (il valore più lontano sulla fotocamera potrebbe essere diminuito lo zoom). | |
| float | maxZoom |
| Zoom massimo (il valore più vicino alla fotocamera potrebbe essere alla Terra). | |
| BOOL | buildingsEnabled |
| Se impostato, gli edifici in 3D verranno mostrati, se disponibili. | |
| BOOL | indoorEnabled |
| Consente di impostare la visualizzazione delle mappe di interni, ove disponibili. | |
| GMSIndoorDisplay * | indoorDisplay |
| Recupera l'istanza GMSIndoorDisplay che consente di osservare o controllare aspetti della visualizzazione dei dati degli 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 il modo in cui gli riquadri dell'area sicura vengono aggiunti ai valori di spaziatura interna. | |
| BOOL | accessibilityElementsHidden |
| Il valore predefinito è YES. | |
| GMSMapLayer * | strato |
| Funzione di accesso per il tipo CAlivello personalizzato utilizzato per il livello. | |
| GMSFrameRate | preferredFrameRate |
| Controlla la frequenza fotogrammi del rendering. | |
| GMSCoordinateBounds * | cameraTargetBounds |
| Se il valore è impostato su zero, vincola l'obiettivo della videocamera in modo che i gesti non lo facciano uscire dai limiti specificati. | |
| GMSMapCapabilityFlags | mapCapabilities |
| Tutte le funzionalità a disponibilità condizionale (dipendenti da MapID o altre impostazioni della mappa) al momento disponibili. | |
Funzioni correlate | |
Tieni presente che non si tratta di funzioni relative ai membri. | |
| NSString *const | kGMSAccessibilityCompass |
| Identificatore di accessibilità del pulsante della bussola. | |
| NSString *const | kGMSAccessibilityMyLocation |
| Identificatore di accessibilità per il pulsante "La mia posizione". | |
| NSString *const | kGMSAccessibilityOutOfQuota |
| Identificatore di accessibilità per l'etichetta di errore "out of quota". | |
Documentazione sulle funzioni dei membri
| - (instancetype) init |
Inizializza con CGRectZero e le opzioni predefinite.
| - (instancetype) initWithOptions: | (GMSMapViewOptions non nullo *) | opzioni |
Crea una nuova visualizzazione della mappa con le opzioni specificate.
Il valore dell'oggetto options viene copiato con questo metodo.
| - (instancetype) initWithFrame: | (CGRect) | cornice |
| - (tipo di istanza con valore nullo) initWithCoder: | (NSCoder *) | programma |
| + (instancetype) mapWithFrame: | (CGRect) | cornice | |
| videocamera: | (GMSCameraPosition *) | da 64 MP | |
Crea e restituisce una visualizzazione mappa con un frame e un obiettivo della fotocamera.
| + (instancetype) mapWithFrame: | (CGRect) | cornice | |
| ID mappa: | (GMSMapID *) | mapID | |
| videocamera: | (GMSCameraPosition *) | da 64 MP | |
Pratico inizializzatore per creare e restituire una visualizzazione mappa con un frame, un ID mappa e un obiettivo della fotocamera.
| - (instancetype) initWithFrame: | (CGRect) | cornice | |
| videocamera: | (GMSCameraPosition *) | da 64 MP | |
Crea e restituisce una visualizzazione mappa, con un frame e un obiettivo della videocamera.
- Nota:
- Questa strategia è deprecata. Utilizza -init o -initWithOptions:.
| - (instancetype) initWithFrame: | (CGRect) | cornice | |
| ID mappa: | (GMSMapID *) | mapID | |
| videocamera: | (GMSCameraPosition *) | da 64 MP | |
Crea e restituisce una visualizzazione mappa con un frame, un ID mappa e un obiettivo della fotocamera.
- Nota:
- Questa strategia è deprecata. Utilizza -init o -initWithOptions:.
| - (void) startRendering |
Indica alla mappa di potenziare il renderer.
È facoltativo e idempotente.
- Nota:
- Questa strategia è deprecata. Questo metodo è obsoleto e verrà rimosso in una release futura.
| - (void) stopRendering |
Indica alla mappa di spegnere il renderer.
È facoltativo e idempotente.
- Nota:
- Questa strategia è deprecata. Questo metodo è obsoleto e verrà rimosso in una release futura.
| - (void) chiaro |
Cancella tutti i markup aggiunti alla mappa, compresi indicatori, polilinee e overlay al suolo.
Il punto della posizione visibile non verrà cancellato e il mapType corrente non verrà reimpostato.
| - (void) setMinZoom: | (float) | minZoom | |
| maxZoom: | (float) | maxZoom | |
Imposta minZoom e maxZoom.
Questo metodo prevede che il minimo sia inferiore o uguale al massimo e, in caso contrario, genera un'eccezione con il nome NSRangeException.
| - (nullable GMSCameraPosition *) cameraForBounds: | (GMSCoordinateBounds *) | limiti | |
| riquadri: | (UIEdgeInset) | insiemi | |
Crea una GMSCameraPosition che presenti bounds con padding.
La videocamera non avrà un orientamento e un'inclinazione zero (ovvero è rivolta a nord e guarda direttamente la Terra). Vengono presi in considerazione il frame e la spaziatura interna di questo GMSMapView.
Se i limiti non sono validi, questo metodo restituisce una fotocamera zero.
| - (void) moveCamera: | (GMSCameraUpdate *) | aggiorna |
Modifica la fotocamera in base a update.
Il cambio della fotocamera è istantaneo (senza animazione).
| - (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition *) | position | |
| posizione: | (GMSCameraPosition *) | otherPosition | |
Controlla se le posizioni date della videocamera potrebbero causare praticamente lo stesso rendering della videocamera, tenendo conto del livello di precisione e delle trasformazioni utilizzate internamente.
| - (GMSFeatureLayer<GMSPlaceFeature *> *) featurelayerOfFeatureType: | (GMSFeatureType) | featureType |
Restituisce un livello di caratteristiche del tipo specificato.
I livelli degli elementi devono essere configurati nella console Cloud.
Se su questa mappa non esiste un livello del tipo specificato, se gli stili basati sui dati non sono attivati o se non viene utilizzato il framework di rendering Metal, il valore isAvailable del livello risultante sarà NO e non risponderà ad alcuna chiamata.
Richiede il renderer Metal. Scopri come attivare Metal all'indirizzo https://developers.google.com/maps/documentation/ios-sdk/config#use-metal
| - (GMSDatasetFeatureLayer *) datasetFeatureLivelloOfDatasetID: | (NSString *) | datasetID |
Restituisce un livello delle caratteristiche del set di dati specificato.
Gli ID set di dati devono essere configurati nella console Cloud.
Se su questa mappa non esiste un set di dati dell'ID specificato o se gli stili basati sui dati non sono attivati, il valore isAvailable del livello risultante sarà NO e non risponderà ad alcuna chiamata.
| - (void) animateToCameraPosition: | (GMSCameraPosition *) | cameraPosition |
Consente di avviare l'animazione della fotocamera di questa mappa fino a cameraPosition.
| - (void) animateToLocation: | (CLLocationCoordinate2D) | località |
Come animateToCameraPosition:, ma cambia solo la posizione della fotocamera (ad esempio, dalla posizione corrente a location).
| - (void) animateToZoom: | (float) | eseguire lo zoom |
Come animateToCameraPosition:, ma modifica solo il livello di zoom della fotocamera.
Questo valore è bloccato da [kGMSMinZoomLevel, kGMSMaxZoomLevel].
| - (void) animateToBearing: | (CLLocationDirection) | cuscinetto |
Come animateToCameraPosition:, ma modifica solo l'orientamento della fotocamera (in gradi).
Zero indica il vero nord.
| - (void) animateToViewingAngle: | (doppio) | viewingAngle |
Come animateToCameraPosition:, ma modifica solo l'angolo di visualizzazione della fotocamera (in gradi).
Questo valore sarà fissato a un minimo di zero (ovvero, rivolto verso il basso) e tra 30 e 45 gradi verso l'orizzonte, a seconda della relativa vicinanza alla terra.
| - (void) animateWithCameraUpdate: | (GMSCameraUpdate *) | cameraUpdate |
Applica cameraUpdate alla fotocamera corrente e poi utilizza il risultato come animatoToCameraPosition:.
Documentazione sugli amici e sulle funzioni correlate
- (NSString* const) kGMSAccessibilityCompass [related] |
Identificatore di accessibilità del 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 "out of quota".
Documentazione della proprietà
- (ID IBOutlet<GMSMapViewDelegate>) delegato [read, write, assign] |
Delegato GMSMapView.
- (GMSCameraPosition*) fotocamera [read, write, copy] |
Controlla la fotocamera, che definisce il modo in cui è orientata la mappa.
La modifica di questa proprietà è istantanea.
- (GMSProjection*) proiezione [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, 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 e il cerchio di precisione La mia posizione.
Il valore predefinito è NO.
- (CLLocation*) myLocation [read, assign] |
Se la funzionalità La mia posizione è attiva, mostra dove è stato tracciato il punto con la posizione del dispositivo.
Se viene disattivato o se viene attivato, ma non sono disponibili dati sulla posizione, l'impostazione non sarà valida. Questa proprietà è osservabile tramite KVO.
- (GMSMarker*) selectedMarker [read, write, assign] |
L'indicatore selezionato.
L'impostazione di questa proprietà consente di selezionare un determinato indicatore e di visualizzare una finestra informativa. Se questa proprietà è diversa da zero e la imposti su null, l'indicatore viene deselezionato e la finestra informativa viene nascosta. Questa proprietà è osservabile tramite KVO.
- (BOOL) trafficEnabled [read, write, assign] |
Consente di stabilire se la mappa sta tracciando dati sul traffico, se disponibili.
Questa opzione è soggetta alla disponibilità dei dati sul traffico. Il valore predefinito è NO.
- (GMSMapViewType) mapType [read, write, assign] |
Controlla il tipo di riquadri di 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 il valore di mapType è Normale.
- (UIUserInterfaceStyle) overrideUserInterfaceStyle [read, write, assign] |
Modifica la mappa impostandola sullo UIUserInterfaceStyle desiderato.
Questa operazione sostituisce il comportamento predefinito UIKit e viene impostato in modo predefinito su UIUserInterfaceStyleLight per garantire la compatibilità con le versioni precedenti. Questa impostazione influisce sulla combinazione di colori dei tipi di mappe Normale e Rilievo.
- minZoom [read, assign] (in virgola mobile) |
Zoom minimo (il valore più lontano sulla fotocamera potrebbe essere diminuito lo zoom).
Il valore predefinito è kGMSMinZoomLevel. Modificato con -setMinZoom:maxZoom:.
- maxZoom [read, assign] (in virgola mobile) |
Zoom massimo (il valore più vicino alla fotocamera potrebbe essere 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 è YES.
Ciò può essere utile quando aggiungi un livello di riquadri personalizzato alla mappa, in modo da renderlo più chiaro a livelli di zoom elevati. La modifica di questo valore comporterà l'invalidazione breve di tutti i riquadri.
- (BOOL) indoorEnabled [read, write, assign] |
Consente di impostare la visualizzazione delle mappe di interni, ove disponibili.
Il valore predefinito è YES.
Se viene impostato su NO, le cache per i dati interni possono essere eliminate definitivamente e qualsiasi prezzo minimo attualmente selezionato dall'utente finale può essere reimpostato.
- (GMSIndoorDisplay*) indoorDisplay [read, assign] |
Recupera l'istanza GMSIndoorDisplay che consente di osservare o controllare aspetti della visualizzazione dei dati degli 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à dati della mappa ma non controlli UI.
Se la spaziatura interna non è bilanciata, il centro visivo della vista si sposterà in modo appropriato. La spaziatura interna influirà anche sulla proprietà projection, pertanto la regione visibile non includerà l'area. GMSCameraUpdate fitToBounds garantirà che sia questa spaziatura interna sia quella richiesta siano prese in considerazione.
Questa proprietà può essere animata all'interno di un blocco di animazione basato su UIView.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
Controlla il modo in cui gli riquadri dell'area sicura 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 La mia posizione e il selettore del piano all'interno dell'area sicura del dispositivo.
Il valore predefinito è kGMSMapViewPaddingAdjustBehavioralways.
- (BOOL) accessibilityElementsHidden [read, write, assign] |
Il valore predefinito è YES.
Se impostato su NO, GMSMapView genererà elementi di accessibilità per gli oggetti overlay, come GMSMarker e GMSPolyline.
Questa proprietà segue il protocollo informale UIAccessibility, ad eccezione del valore predefinito YES.
- (GMSMapLayer*) livello [read, retain] |
Funzione di accesso per il tipo CAlivello personalizzato utilizzato per il livello.
- (GMSFrameRate) preferredFrameRate [read, write, assign] |
Controlla la frequenza fotogrammi del rendering.
Il valore predefinito è kGMSFrameRateMax.
- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign] |
Se il valore è impostato su zero, vincola l'obiettivo della videocamera in modo che i gesti non lo facciano uscire dai limiti specificati.
- (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
Tutte le funzionalità a disponibilità condizionale (dipendenti da MapID o altre impostazioni della mappa) al momento disponibili.
Non include funzionalità sempre disponibili.