GMSMarker-Klassenreferenz


Überblick

Eine Markierung ist ein Symbol, das an einem bestimmten Punkt auf der Kartenoberfläche platziert wird.

Das Symbol einer Markierung ist nicht an der Oberfläche der Karte, sondern am Gerätebildschirm ausgerichtet. Das heißt, es ändert sich nicht unbedingt aufgrund von Kartendrehungen, Neigen oder Zoomen.

Übernimmt GMSOverlay.

Übernommen von GMSAdvancedMarker.

Statische Funktionen für öffentliche Mitglieder

(Instanztyp)+ markerWithPosition:
 Convenience-Konstruktor für eine Standardmarkierung.
(UIImage *)+ markerImageWithColor:
 Erstellt eine eingefärbte Version des Standardmarkierungsbilds zur Verwendung als Symbol.

Attribute

CLLocationCoordinate2DPosition
 Markierungsposition.
NSString * Snippet
 Snippet-Text, der unter dem Titel im Infofenster angezeigt wird, wenn er ausgewählt wird
UIImage * icon
 Zu renderndes Markierungssymbol.
UIView * iconView
 Zu rendernde Markierungsansicht.
BOOLtracksViewChanges
 Steuert, ob das Symbol für diese Markierung für jeden Frame neu gezeichnet werden soll.
BOOLtracksInfoWindowChanges
 Steuert, ob das Infofenster für diese Markierung für jeden Frame neu gezeichnet werden soll.
CGPointgroundAnchor
 Der Bodenanker gibt den Punkt im Symbolbild an, der an der Position der Markierung auf der Erdoberfläche verankert ist.
CGPointinfoWindowAnchor
 Die Infofensterverankerung gibt den Punkt im Symbolbild an, an dem das Infofenster verankert werden soll, das direkt über diesem Punkt angezeigt wird.
GMSMarkerAnimationappearAnimation
 Steuert die Animation, die verwendet wird, wenn diese Markierung in einer GMSMapView platziert wird (Standard kGMSMarkerAnimationNone, keine Animation).
BOOLziehbar
 Steuert, ob diese Markierung interaktiv gezogen werden kann (Standardeinstellung NEIN).
BOOLflach
 Steuert, ob diese Markierung flach auf der Erdoberfläche anliegt (JA), oder eine in die Kamera gerichtete Billboard-Anzeige (NO, Standardeinstellung).
CLLocationDegreesRotation
 Legt die Drehung der Markierung in Grad im Uhrzeigersinn um ihren Ankerpunkt fest.
float Deckkraft
 Legt die Deckkraft der Markierung fest und liegt zwischen 0 (vollständig transparent) und 1 (Standardwert).
GMSMarkerLayerEbene
 Stellt die Kernanimationsebene für diesen GMSMarker bereit.
GMSPanoramaViewpanoramaView
 panoramaView gibt an, in welcher Panoramaansicht diese Markierung angezeigt werden soll.
NSString * title
 Titel: eine kurze Beschreibung des Overlays.
GMSMapViewKarte
 Die Karte, auf der sich dieses Overlay befindet
BOOLantippbar
 Ob dieses Overlay Benachrichtigungen zu Tippaktionen auslöst.
int zIndex
 Overlays mit einem höheren Wert von zIndex werden über Kachelebenen und Overlays mit einem niedrigeren Wert von zIndex gezeichnet.
id [ID]userData
 Overlay-Daten

Dokumentation zu Mitgliederfunktionen

+ (instancetype) markerWithPosition: (CLLocationCoordinate2D)  Position

Convenience-Konstruktor für eine Standardmarkierung.

+ (UIImage *) markerImageWithColor: (nullable UIColor *)  Farbe

Erstellt eine eingefärbte Version des Standardmarkierungsbilds zur Verwendung als Symbol.


Property-Dokumentation

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

Markierungsposition.

Animiert.

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

Snippet-Text, der unter dem Titel im Infofenster angezeigt wird, wenn er ausgewählt wird

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

Zu renderndes Markierungssymbol.

Wenn der Wert null ist, wird eine standardmäßige SDK-Ortsmarkierung verwendet.

Unterstützt animierte Bilder, aber jeder Frame muss die gleiche Größe haben oder das Verhalten ist nicht definiert.

Unterstützt die Verwendung von alignRectInsets, um eine reduzierte Interaktionsfläche anzugeben. Dadurch wird auch neu definiert, wie Anker angegeben werden. Bei einem animierten Bild wird der Wert für die Animation verwendet, nicht die einzelnen Frames.

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

Zu rendernde Markierungsansicht.

Wenn der Wert „nil“ ist, wird stattdessen auf das Attribut icon zurückgesetzt.

Unterstützt Animationen aller animierbaren Eigenschaften von UIView mit Ausnahme von frame und center. Das Ändern dieser Attribute oder der entsprechenden CALayer-Version, einschließlich position, wird nicht unterstützt.

Die Ansicht verhält sich unabhängig vom tatsächlichen Wert so, als wäre clipsToBounds auf JA festgelegt.

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

Steuert, ob das Symbol für diese Markierung für jeden Frame neu gezeichnet werden soll.

Wenn sich dieser Wert von NO zu YES ändert, wird das Symbol garantiert neu gezeichnet.

Die Standardeinstellung ist YES (JA). Hat keine Auswirkungen, wenn iconView „nil“ ist.

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

Steuert, ob das Infofenster für diese Markierung für jeden Frame neu gezeichnet werden soll.

Wenn sich dieser Wert von NO zu YES ändert, wird das Infofenster garantiert neu gezeichnet.

Die Standardeinstellung ist „NO“.

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

Der Bodenanker gibt den Punkt im Symbolbild an, der an der Position der Markierung auf der Erdoberfläche verankert ist.

Dieser Punkt wird innerhalb des durchgehenden Bereichs [0,0, 1,0] x [0,0, 1,0] angegeben, wobei (0,0) die linke obere Ecke des Bildes und (1,1) die untere rechte Ecke ist.

Wenn für das Bild ein „alignRectInsets“ ungleich null ist, beziehen sich die oben erwähnten Optionen „oben links“ und „unten rechts“ auf den „Inset“-Abschnitt des Bildes.

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

Die Infofensterverankerung gibt den Punkt im Symbolbild an, an dem das Infofenster verankert werden soll, das direkt über diesem Punkt angezeigt wird.

Dieser Punkt befindet sich im selben Raum wie „groundAnchor“.

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

Steuert die Animation, die verwendet wird, wenn diese Markierung in einer GMSMapView platziert wird (Standard kGMSMarkerAnimationNone, keine Animation).

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

Steuert, ob diese Markierung interaktiv gezogen werden kann (Standardeinstellung NEIN).

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

Steuert, ob diese Markierung flach auf der Erdoberfläche anliegt (JA), oder eine in die Kamera gerichtete Billboard-Anzeige (NO, Standardeinstellung).

– (CLLocationDegrees) rotation [read, write, assign]

Legt die Drehung der Markierung in Grad im Uhrzeigersinn um ihren Ankerpunkt fest.

Die Rotationsachse ist senkrecht zur Markierung. Eine Drehung 0 entspricht der Standardposition der Markierung. Animiert.

Wenn die Markierung flach auf der Karte aufliegt, ist die Standardposition nach Norden ausgerichtet und die Markierung ist so gedreht, dass sie immer flach auf der Karte bleibt. Wenn die Markierung eine Billboard-Anzeige ist, zeigt sie nach oben und ist so gedreht, dass sie immer der Kamera gegenüberliegt.

- (Gleitkommazahl) opacity [read, write, assign]

Legt die Deckkraft der Markierung fest und liegt zwischen 0 (vollständig transparent) und 1 (Standardwert).

- (GMSMarkerLayer*) Ebene [read, assign]

Stellt die Kernanimationsebene für diesen GMSMarker bereit.

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

panoramaView gibt an, in welcher Panoramaansicht diese Markierung angezeigt werden soll.

Wenn die position der Markierung zu weit vom aktuellen Panoramastandort der panoramaView entfernt ist, wird sie nicht angezeigt, da sie zu klein ist.

Kann auf nil gesetzt werden, um die Markierung aus jeder aktuellen Panoramaansicht zu entfernen, mit der sie verbunden ist.

Eine Markierung kann gleichzeitig auf einem Panorama und auf einer Karte angezeigt werden.

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

Titel: eine kurze Beschreibung des Overlays.

Einige Overlays, z. B. Markierungen, zeigen den Titel auf der Karte an. Der Titel ist auch der standardmäßige Text für Bedienungshilfen.

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

Die Karte, auf der sich dieses Overlay befindet

Wenn diese Eigenschaft festgelegt wird, wird das Overlay zur Karte hinzugefügt. Wenn der Wert auf null gesetzt wird, wird dieses Overlay von der Karte entfernt. Ein Overlay kann jeweils auf maximal einer Karte aktiv sein.

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

Ob dieses Overlay Benachrichtigungen zu Tippaktionen auslöst.

Einige Overlays, z. B. Markierungen, sind standardmäßig antippbar.

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

Overlays mit einem höheren Wert von zIndex werden über Kachelebenen und Overlays mit einem niedrigeren Wert von zIndex gezeichnet.

Gleiche Werte führen zu einer undefinierten Zeichenreihenfolge. Markierungen sind die Ausnahme, dass sie unabhängig von zIndex immer über Kachelebenen und anderen Overlays ohne Markierungen gezeichnet werden. Sie werden praktisch so behandelt, als würden sie im Vergleich zu anderen Overlays in einer separaten Z-Index-Gruppe erscheinen.

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

Overlay-Daten

Du kannst diese Eigenschaft verwenden, um ein beliebiges Objekt mit diesem Overlay zu verknüpfen. Das Google Maps SDK for iOS liest oder schreibt diese Property weder.

Beachten Sie, dass userData keine starken Verweise auf Maps-Objekte enthalten sollte, da andernfalls ein Aufbewahrungszyklus erstellt werden kann, um zu verhindern, dass Objekte freigegeben werden.