Riferimento alla classe GMSMarker

Riferimento classe GMSMarker

Panoramica

Un indicatore è un'icona posizionata in un determinato punto sulla superficie della mappa.

L'icona di un indicatore viene disegnata orientata in base allo schermo del dispositivo e non alla superficie della mappa; ciò significa che non cambierà necessariamente l'orientamento a causa di rotazioni, inclinazioni o zoom della mappa.

Eredita GMSOverlay.

Ereditato da GMSAdvancedMarker.

Funzioni membri pubbliche statiche

(instancetype)+ markerWithPosition:
 Costruttore pratico per un indicatore predefinito.
(UIImage *)+ marcatoreImageWithColor:
 Crea una versione colorata dell'immagine dell'indicatore predefinita da utilizzare come icona.

Proprietà

CLLocationCoordinate2Dposition
 Posizione dell'indicatore.
NSString * snippet
 Testo dello snippet, visualizzato sotto il titolo nella finestra informativa quando viene selezionato.
Immagine UI * icona
 Icona indicatore da visualizzare.
UIView * iconView
 Visualizzazione indicatore da visualizzare.
BOOLtracksViewChanges
 Consente di stabilire se ritracciare l'icona di questo indicatore a ogni frame.
BOOLtracksInfoWindowChanges
 Consente di stabilire se la finestra informativa di questo indicatore deve essere ridisegnata ogni frame.
Punto CGgroundAnchor
 L'ancoraggio al suolo specifica il punto nell'immagine dell'icona ancorato alla posizione dell'indicatore sulla superficie del pianeta.
Punto CGinfoWindowAnchor
 L'ancoraggio della finestra informativa specifica il punto nell'immagine dell'icona a cui ancorare la finestra informativa, che verrà visualizzata direttamente sopra questo punto.
GMSMarkerAnimationappearAnimation
 Consente di stabilire l'animazione utilizzata quando questo indicatore viene posizionato su un elemento GMSMapView (impostazione predefinita: kGMSMarkerAnimationNone, nessuna animazione).
BOOLtrascinabile
 Consente di stabilire se questo indicatore può essere trascinato in modo interattivo (impostazione predefinita NO).
BOOLpiatto
 Consente di stabilire se l'indicatore deve essere piatto sulla superficie terrestre (SÌ) o su un cartellone pubblicitario rivolto verso la fotocamera (NO, l'impostazione predefinita).
CLLocationDegreesrotazione
 Imposta la rotazione dell'indicatore in gradi in senso orario rispetto al punto di ancoraggio dell'indicatore.
float opacità
 Consente di impostare l'opacità dell'indicatore, compresa tra 0 (completamente trasparente) e 1 (predefinito).
GMSMarkerLayerlivello
 Fornisce il livello dell'animazione principale per GMSMarker.
GMSPanoramaViewpanoramaView
 L'panoramaView specifica la visualizzazione panoramica che tenterà di mostrare questo indicatore.
NSString * title
 Titolo: una breve descrizione dell'overlay.
GMSMapViewmappa
 La mappa su cui si trova questo overlay.
BOOLtoccabile
 Questo overlay dovrebbe causare notifiche con tocco.
int zIndex
 Gli overlay con valori zIndex superiori verranno disegnati sopra i livelli e gli overlay dei riquadri con valori zIndex inferiori.
IDuserData
 Dati in overlay.

Documentazione sulle funzioni membri

+ (instancetype) markerWithPosition: (CLLocationCoordinate2D)  position

Costruttore pratico per un indicatore predefinito.

+ (UIImage *) marcatoreImageWithColor: (nullable UIColor *)  colore

Crea una versione colorata dell'immagine dell'indicatore predefinita da utilizzare come icona.


Documentazione della proprietà

- (CLLocationCoordinate2D) posizione [read, write, assign]

Posizione dell'indicatore.

Animato.

- (NSString*) snippet [read, write, copy]

Testo dello snippet, visualizzato sotto il titolo nella finestra informativa quando viene selezionato.

- (UIImage*) icona [read, write, assign]

Icona indicatore da visualizzare.

Se il valore è nullo, viene utilizzato un indicatore di posizione predefinito dell'SDK.

Supporta le immagini animate, ma ogni frame deve avere le stesse dimensioni o il comportamento non è definito.

Supporta l'uso di affiliateRectInsets per specificare un'area tocco ridotta. L'operazione ridefinisce inoltre il modo in cui vengono specificati gli anchor. Per un'immagine animata, viene utilizzato il valore dell'animazione, non i singoli frame.

- (UIView*) iconView [read, write, assign]

Visualizzazione indicatore da visualizzare.

Se il criterio viene lasciato nullo, torna alla proprietà icon.

Supporta l'animazione di tutte le proprietà animabili di UIView, ad eccezione di frame e center. La modifica di queste proprietà o della versione di CAlayer corrispondente, tra cui position, non è supportata.

Tieni presente che la vista si comporta come se clipsToBounds fosse impostato su SÌ, indipendentemente dal suo valore effettivo.

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

Consente di stabilire se ritracciare l'icona di questo indicatore a ogni frame.

Tieni presente che quando cambia da NO a SÌ, l'icona verrà ridisegnata nel frame successivo.

Il valore predefinito è SÌ. Non ha effetto se iconView è nullo.

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

Consente di stabilire se la finestra informativa di questo indicatore deve essere ridisegnata ogni frame.

Tieni presente che, se cambia da NO a SÌ, la finestra informativa verrà ridisegnata nel frame successivo.

Il valore predefinito è NO.

- (CGPoint) groundAnchor [read, write, assign]

L'ancoraggio al suolo specifica il punto nell'immagine dell'icona ancorato alla posizione dell'indicatore sulla superficie del pianeta.

Questo punto è specificato all'interno dello spazio continuo [0.0, 1.0] x [0.0, 1.0], dove (0,0) è l'angolo superiore sinistro dell'immagine e (1,1) è l'angolo inferiore destro.

Se l'immagine presenta un valore di allineamento RectInset diverso da zero, le parti in alto a sinistra e in basso a destra menzionate sopra si riferiscono alla sezione con inserto dell'immagine.

- (CGPoint) infoWindowAnchor [read, write, assign]

L'ancoraggio della finestra informativa specifica il punto nell'immagine dell'icona a cui ancorare la finestra informativa, che verrà visualizzata direttamente sopra questo punto.

Questo punto è specificato all'interno dello stesso spazio dell'elemento groundAnchor.

- (GMSMarkerAnimation) appearAnimation [read, write, assign]

Consente di stabilire l'animazione utilizzata quando questo indicatore viene posizionato su un elemento GMSMapView (impostazione predefinita: kGMSMarkerAnimationNone, nessuna animazione).

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

Consente di stabilire se questo indicatore può essere trascinato in modo interattivo (impostazione predefinita NO).

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

Consente di stabilire se l'indicatore deve essere piatto sulla superficie terrestre (SÌ) o su un cartellone pubblicitario rivolto verso la fotocamera (NO, l'impostazione predefinita).

- Rotazione (CLLocationDegrees) [read, write, assign]

Imposta la rotazione dell'indicatore in gradi in senso orario rispetto al punto di ancoraggio dell'indicatore.

L'asse di rotazione è perpendicolare all'indicatore. Una rotazione pari a 0 corrisponde alla posizione predefinita dell'indicatore. Animato.

Quando l'indicatore è piatto sulla mappa, la posizione predefinita è allineata a nord e la rotazione è tale che l'indicatore rimanga sempre piatto sulla mappa. Quando l'indicatore è un cartellone pubblicitario, la posizione predefinita è rivolta verso l'alto e la rotazione è tale che l'indicatore è sempre rivolto verso la fotocamera.

- Opacità (float) [read, write, assign]

Consente di impostare l'opacità dell'indicatore, compresa tra 0 (completamente trasparente) e 1 (predefinito).

- Livello (GMSMarkerLayer*) [read, assign]

Fornisce il livello dell'animazione principale per GMSMarker.

- (GMSPanoramaView*) panoramaView [read, write, assign]

L'panoramaView specifica la visualizzazione panoramica che tenterà di mostrare questo indicatore.

Tieni presente che se l'indicatore position è troppo lontano dalla posizione del panorama corrente dell'panoramaView, non verrà visualizzato perché è troppo piccolo.

Può essere impostato su zero per rimuovere l'indicatore da qualsiasi visualizzazione panoramica corrente a cui è associato.

Un indicatore può essere visualizzato contemporaneamente su una panoramica e su una mappa.

- (NSString*) title [read, write, copy, inherited]

Titolo: una breve descrizione dell'overlay.

Alcuni overlay, come gli indicatori, mostrano il titolo sulla mappa. Il titolo è anche il testo predefinito sull'accessibilità.

- mappa (GMSMapView*) [read, write, assign, inherited]

La mappa su cui si trova questo overlay.

L'impostazione di questa proprietà aggiungerà l'overlay alla mappa. Se viene impostato su null, l'overlay viene rimosso dalla mappa. Un overlay può essere attivo su al massimo una mappa alla volta.

- (BOOL) toccabile [read, write, assign, inherited]

Questo overlay dovrebbe causare notifiche con tocco.

Per impostazione predefinita, alcuni overlay, ad esempio gli indicatori, potranno essere toccati.

- (int) zIndex [read, write, assign, inherited]

Gli overlay con valori zIndex superiori verranno disegnati sopra i livelli e gli overlay dei riquadri con valori zIndex inferiori.

Valori uguali comportano un ordine di disegno indefinito. Gli indicatori rappresentano un'eccezione: indipendentemente da zIndex, saranno sempre tracciati al di sopra dei livelli dei riquadri e di altri overlay diversi dagli indicatori; vengono effettivamente considerati in un gruppo z-index separato rispetto ad altri overlay.

- (id) userData [read, write, assign, inherited]

Dati in overlay.

Puoi utilizzare questa proprietà per associare un oggetto arbitrario a questo overlay. L'SDK di Google Maps per iOS non legge né scrive questa proprietà.

Tieni presente che userData non deve contenere riferimenti chiari a oggetti di Maps, altrimenti potrebbe essere creato un ciclo di conservazione (impedendo il rilascio degli oggetti).