Ü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 | |
CLLocationCoordinate2D | Position |
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. | |
BOOL | tracksViewChanges |
Steuert, ob das Symbol für diese Markierung für jeden Frame neu gezeichnet werden soll. | |
BOOL | tracksInfoWindowChanges |
Steuert, ob das Infofenster für diese Markierung für jeden Frame neu gezeichnet werden soll. | |
CGPoint | groundAnchor |
Der Bodenanker gibt den Punkt im Symbolbild an, der an der Position der Markierung auf der Erdoberfläche verankert ist. | |
CGPoint | infoWindowAnchor |
Die Infofensterverankerung gibt den Punkt im Symbolbild an, an dem das Infofenster verankert werden soll, das direkt über diesem Punkt angezeigt wird. | |
GMSMarkerAnimation | appearAnimation |
Steuert die Animation, die verwendet wird, wenn diese Markierung in einer GMSMapView platziert wird (Standard kGMSMarkerAnimationNone, keine Animation). | |
BOOL | ziehbar |
Steuert, ob diese Markierung interaktiv gezogen werden kann (Standardeinstellung NEIN). | |
BOOL | flach |
Steuert, ob diese Markierung flach auf der Erdoberfläche anliegt (JA), oder eine in die Kamera gerichtete Billboard-Anzeige (NO, Standardeinstellung). | |
CLLocationDegrees | Rotation |
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). | |
GMSMarkerLayer * | Ebene |
Stellt die Kernanimationsebene für diesen GMSMarker bereit. | |
GMSPanoramaView * | panoramaView |
panoramaView gibt an, in welcher Panoramaansicht diese Markierung angezeigt werden soll. | |
NSString * | title |
Titel: eine kurze Beschreibung des Overlays. | |
GMSMapView * | Karte |
Die Karte, auf der sich dieses Overlay befindet | |
BOOL | antippbar |
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.