Referenz zur GMSMarker-Klasse


Übersicht

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

Das Symbol einer Markierung wird am Gerätebildschirm ausgerichtet und nicht an der Oberfläche der Karte. Das heißt, es ändert sich nicht unbedingt die Ausrichtung aufgrund von Drehungen, Neigungen oder Zoomen der Karte.

Übernimmt GMSOverlay.

Übernommen von GMSAdvancedMarker.

Statische Funktionen für öffentliche Mitglieder

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

Eigenschaften

CLLocationCoordinate2DPosition
 Markierungsposition.
NSString * Snippet
 Der Snippet-Text wird bei Auswahl unter dem Titel im Infofenster angezeigt.
UIImage * icon
 Zu renderndes Markierungssymbol.
UIView * Symbolansicht
 Zu rendernde Markierungsansicht.
BOOLtracksViewChanges
 Steuert, ob das Symbol für diese Markierung in jedem Frame neu gezeichnet werden soll.
BOOLtracksInfoWindowChanges
 Steuert, ob das Infofenster für diese Markierung 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.
GMSMarkerAnimationangezeigteAnimation
 Steuert die Animation, die verwendet wird, wenn diese Markierung auf einer GMSMapView platziert wird (Standard kGMSMarkerAnimationNone, keine Animation).
BOOLziehbar
 Steuert, ob diese Markierung interaktiv gezogen werden kann (Standardeinstellung "NO").
BOOLflach
 Steuert, ob diese Markierung flach an der Erdoberfläche anliegen soll (JA) oder auf eine zur Kamera gerichtete Plakatwand (NEIN, Standardeinstellung) wird.
CLLocationDegreesRotation
 Legt die Drehung der Markierung in Grad im Uhrzeigersinn um ihren Ankerpunkt fest.
GleitkommazahlDeckkraft
 Legt die Deckkraft der Markierung fest und liegt zwischen 0 (vollständig transparent) und 1 (Standardeinstellung).
GMSMarkerLayerEbene
 Stellt die Core Animation-Ebene 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
BOOLanklickbar
 Ob durch dieses Overlay Benachrichtigungen beim Antippen ausgelöst werden sollen
GanzzahlzIndex
 Overlays mit einem höheren zIndex-Wert werden über Kachelebenen und Overlays mit niedrigerem zIndex-Wert gezeichnet.
IDuserData
 Overlay-Daten

Dokumentation zu Mitgliederfunktionen

+ (instancetype) markerWithPosition: (CLLocationCoordinate2D) Position

Praktischer Konstruktor für eine Standardmarkierung.

+ (UIImage *) markerImageWithColor: (UIColor ohne Nullwerte *) 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]

Der Snippet-Text wird bei Auswahl unter dem Titel im Infofenster angezeigt.

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

Zu renderndes Markierungssymbol.

Ist null angegeben, wird eine standardmäßige SDK-Ortsmarkierung verwendet.

Unterstützt animierte Bilder, aber jeder Frame muss dieselbe 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 null ist, wird stattdessen auf das Attribut icon zurückgesetzt.

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

Beachten Sie, dass sich die Ansicht so verhält, als wäre clipsToBounds auf JA gesetzt, unabhängig vom tatsächlichen Wert.

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

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

Hinweis: Wenn sich dieser Wert von NO in YES ändert, wird das Symbol garantiert als nächsten Frame neu gezeichnet.

Die Standardeinstellung ist YES (JA). Hat keine Auswirkungen, wenn iconView null ist.

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

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

Beachten Sie, dass das Infofenster in jedem Fall neu gezeichnet wird, wenn sich dieser Wert von NO in YES ändert.

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 Abstands [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 das Bild „alignRectInsets“ ungleich null hat, beziehen sich die oben erwähnten Elemente links oben und unten rechts auf den Einfügungsabschnitt 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 wird im selben Raum wie „groundAnchor“ angegeben.

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

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

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

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

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

Steuert, ob diese Markierung flach an der Erdoberfläche anliegen soll (JA) oder auf eine zur Kamera gerichtete Plakatwand (NEIN, Standardeinstellung) wird.

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

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

Die Rotationsachse verläuft senkrecht zur Markierung. Eine Drehung 0 entspricht der Standardposition der Markierung. Animiert.

Wenn die Markierung flach auf der Karte aufliegt, ist sie standardmäßig nach Norden ausgerichtet und 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) Deckkraft [read, write, assign]

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

- (GMSMarkerLayer*) Ebene [read, assign]

Stellt die Core Animation-Ebene für diesen GMSMarker bereit.

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

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

Hinweis: Wenn der position der Markierung zu weit vom aktuellen Panoramastandort von panoramaView entfernt ist, wird er nicht angezeigt, da er zu klein ist.

Kann auf nil gesetzt werden, um die Markierung aus jeder aktuellen Panoramaansicht zu entfernen, an die sie angehängt ist.

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

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

Titel, eine kurze Beschreibung des Overlays.

Einige Overlays wie Markierungen zeigen den Titel auf der Karte an. Der Titel ist außerdem der Standardtext für Bedienungshilfen.

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

Die Karte, auf der sich dieses Overlay befindet

Durch Festlegen dieser Eigenschaft wird das Overlay zur Karte hinzugefügt. Wenn Sie den Wert auf null setzen, wird dieses Overlay von der Karte entfernt. Ein Overlay kann jeweils höchstens auf einer Karte aktiv sein.

– (BOOL) anklickbar [read, write, assign, inherited]

Ob durch dieses Overlay Benachrichtigungen beim Antippen ausgelöst werden sollen

Einige Overlays wie Markierungen können standardmäßig angetippt werden.

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

Overlays mit einem höheren zIndex-Wert werden über Kachelebenen und Overlays mit niedrigerem zIndex-Wert gezeichnet.

Gleiche Werte führen zu einer undefinierten Zeichenreihenfolge. Markierungen stellen eine Ausnahme dar, da sie unabhängig von zIndex immer über Kachelebenen und anderen Overlays ohne Markierungen gezeichnet werden. Tatsächlich wird davon ausgegangen, dass sie sich im Vergleich zu anderen Overlays in einer separaten Z-Indexgruppe befinden.

- (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 nicht.

Beachten Sie, dass „userData“ keine starken Verweise auf Maps-Objekte enthalten sollte. Andernfalls wird möglicherweise ein Aufbewahrungszyklus erstellt, um zu verhindern, dass Objekte freigegeben werden.