Ü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 | |
CLLocationCoordinate2D | Position |
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. | |
BOOL | tracksViewChanges |
Steuert, ob das Symbol für diese Markierung in jedem Frame neu gezeichnet werden soll. | |
BOOL | tracksInfoWindowChanges |
Steuert, ob das Infofenster für diese Markierung 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 | angezeigteAnimation |
Steuert die Animation, die verwendet wird, wenn diese Markierung auf einer GMSMapView platziert wird (Standard kGMSMarkerAnimationNone, keine Animation). | |
BOOL | ziehbar |
Steuert, ob diese Markierung interaktiv gezogen werden kann (Standardeinstellung "NO"). | |
BOOL | flach |
Steuert, ob diese Markierung flach an der Erdoberfläche anliegen soll (JA) oder auf eine zur Kamera gerichtete Plakatwand (NEIN, Standardeinstellung) wird. | |
CLLocationDegrees | Rotation |
Legt die Drehung der Markierung in Grad im Uhrzeigersinn um ihren Ankerpunkt fest. | |
Gleitkommazahl | Deckkraft |
Legt die Deckkraft der Markierung fest und liegt zwischen 0 (vollständig transparent) und 1 (Standardeinstellung). | |
GMSMarkerLayer * | Ebene |
Stellt die Core Animation-Ebene 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 | anklickbar |
Ob durch dieses Overlay Benachrichtigungen beim Antippen ausgelöst werden sollen | |
Ganzzahl | zIndex |
Overlays mit einem höheren zIndex -Wert werden über Kachelebenen und Overlays mit niedrigerem zIndex -Wert gezeichnet. | |
ID | userData |
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.