Przegląd
Znacznik zaawansowany to ikona umieszczona w określonym punkcie na powierzchni mapy.
Dziedziczy GMSMarker.
Statyczne publiczne funkcje członkowskie | |
(typ instancji) | + markerWithPosition: |
Wygodny konstruktor znacznika domyślnego. | |
(Obraz UI *) | + markerImageWithColor: |
Tworzy zabarwioną wersję domyślnego obrazu znacznika do użycia jako ikony. | |
Usługi | |
GMSCollisionBehavior | collisionBehavior |
Zachowanie znacznika w przypadku kolizji, które określa, czy na jego widoczność mogą wpływać inne znaczniki lub oznaczone etykietami treści na mapie. | |
CLLocationCoordinate2D | position |
Pozycja znacznika. | |
NSString * | fragment |
Fragment tekstu, który po wybraniu będzie widoczny pod tytułem w oknie informacyjnym. | |
UIImage * | ikona |
Ikona znacznika do wyrenderowania. | |
UIView * | iconView |
Widok znacznika do wyrenderowania. | |
BOOL | tracksViewChanges |
Określa, czy ikona tego znacznika ma być rysowana ponownie w każdej klatce. | |
BOOL | tracksInfoWindowChanges |
Określa, czy okno informacyjne dla tego znacznika ma być wyświetlane ponownie po każdej klatce. | |
CGPoint | groundAnchor |
Kotwica podstawy określa punkt na obrazie ikony, który jest zakotwiczony w położeniu znacznika na powierzchni Ziemi. | |
CGPoint | infoWindowAnchor |
Kotwica okna informacyjnego określa punkt na obrazie ikony, w którym ma zostać zakotwiczone okno informacyjne wyświetlane bezpośrednio nad tym punktem. | |
GMSMarkerAnimation | appearAnimation |
Kontroluje animację używaną po umieszczeniu tego znacznika w obiekcie GMSMapView (domyślnie kGMSMarkerAnimationNone, brak animacji). | |
BOOL | przeciągany |
Określa, czy ten znacznik można przeciągać interaktywnie (domyślnie NIE). | |
BOOL | płaski |
Określa, czy ten znacznik powinien być płasko względem powierzchni Ziemi (TAK), czy billboardu w stronę kamery (NIE, opcja domyślna). | |
CLLocationStops, | rotacja |
Ustawia obrót znacznika w stopniach w prawo względem jego punktu zakotwiczenia. | |
float | opacity. |
Ustawia przezroczystość znacznika w zakresie od 0 (zupełnie przezroczysta) do 1 (domyślna) włącznie. | |
GMSMarkerLayer * | Warstwa |
Udostępnia warstwę Core Animation dla tego tagu GMSMarker. | |
GMSPanoramaView * | panoramaView |
panoramaView określa, w którym widoku panoramy będzie wyświetlany ten znacznik. | |
NSString * | title |
Tytuł, krótki opis nakładki. | |
GMSMapView * | mapa |
Mapa, na której znajduje się ta nakładka. | |
BOOL | klikalny |
Jeśli ta nakładka powinna generować powiadomienia o kliknięciach. | |
int | zIndex |
Nakładki o wyższej wartości zIndex będą rysowane nad nakładkami i warstwami z kafelkami o niższej wartości zIndex . | |
id [identyfikator] | userData |
Nakładanie danych. |
Dokumentacja funkcji członka
+ (typ instancji) markerWithPosition: | (CLLocationCoordinate2D) | position |
Wygodny konstruktor znacznika domyślnego.
+ (UIImage *) markerImageWithColor: | (nullable UIColor *) | color [kolor] |
Tworzy zabarwioną wersję domyślnego obrazu znacznika do użycia jako ikony.
Dokumentacja usługi
– collisionBehavior (GMSCollisionBehavior) [read, write, assign] |
Zachowanie znacznika w przypadku kolizji, które określa, czy na jego widoczność mogą wpływać inne znaczniki lub oznaczone etykietami treści na mapie.
- (CLLocationCoordinate2D) pozycja [read, write, assign, inherited] |
Pozycja znacznika.
Animowane.
– (NSString*) fragment [read, write, copy, inherited] |
Fragment tekstu, który po wybraniu będzie widoczny pod tytułem w oknie informacyjnym.
– ikona [read, write, assign, inherited] (UIImage*) |
Ikona znacznika do wyrenderowania.
Jeśli pozostawisz wartość nil, używany jest domyślny znacznik miejsca pakietu SDK.
Obsługuje animowane obrazy, ale każda klatka musi mieć ten sam rozmiar lub działanie jest nieokreślone.
Obsługuje użycie wyrównaniaRectInsets do określenia zmniejszonego obszaru kliknięcia. Zmienia też sposób określania kotwic. W przypadku animowanego obrazu używana jest wartość animacji, a nie poszczególnych klatek.
– (UIView*) iconView [read, write, assign, inherited] |
Widok znacznika do wyrenderowania.
Jeśli pozostawisz wartość nil, zamiast tego zostanie użyta właściwość icon
.
Obsługuje animacje wszystkich właściwości animowanych interfejsu UIView z wyjątkiem frame
i center
. Zmiana tych właściwości lub odpowiadających im wersji CALayer, w tym position
, nie jest obsługiwana.
Pamiętaj, że widok zachowuje się tak, jakby clipsToBounds
miał wartość TAK, niezależnie od jej rzeczywistej wartości.
- (BOOL) tracksViewChanges [read, write, assign, inherited] |
Określa, czy ikona tego znacznika ma być rysowana ponownie w każdej klatce.
Pamiętaj, że w przypadku zmiany z NIE na TAK ikona na pewno zostanie ponownie wyświetlona przy następnej klatce.
Domyślna wartość to TAK. Nie działa, jeśli iconView
ma wartość zerową.
- (BOOL) tracksInfoWindowChanges [read, write, assign, inherited] |
Określa, czy okno informacyjne dla tego znacznika ma być wyświetlane ponownie po każdej klatce.
Pamiętaj, że gdy ta opcja zostanie zmieniona z NIE na TAK, okno informacyjne na pewno zostanie ponownie wyświetlone w następnej ramce.
Wartość domyślna to NO.
- (CGPoint) groundAnchor [read, write, assign, inherited] |
Kotwica podstawy określa punkt na obrazie ikony, który jest zakotwiczony w położeniu znacznika na powierzchni Ziemi.
Punkt ten określa się w ciągłej przestrzeni [0,0, 1,0] x [0,0, 1,0], gdzie (0,0) to lewy górny róg obrazu, a (1,1) to prawy dolny róg.
Jeśli wyrównanie obrazu nie jest zerowe, lewy górny i prawy dolny róg obrazu, który jest wspomniany powyżej, odnoszą się do sekcji obrazu.
– (CGPoint) infoWindowAnchor [read, write, assign, inherited] |
Kotwica okna informacyjnego określa punkt na obrazie ikony, w którym ma zostać zakotwiczone okno informacyjne wyświetlane bezpośrednio nad tym punktem.
Ten punkt jest określony w tej samej przestrzeni co obiekt groundAnchor.
– (GMSMarkerAnimation) appearAnimation [read, write, assign, inherited] |
Kontroluje animację używaną po umieszczeniu tego znacznika w obiekcie GMSMapView (domyślnie kGMSMarkerAnimationNone, brak animacji).
- (BOOL) przeciągany [read, write, assign, inherited] |
Określa, czy ten znacznik można przeciągać interaktywnie (domyślnie NIE).
- (BOOL) stałe [read, write, assign, inherited] |
Określa, czy ten znacznik powinien być płasko względem powierzchni Ziemi (TAK), czy billboardu w stronę kamery (NIE, opcja domyślna).
– rotacja [read, write, assign, inherited] (CLLocationDegrs) |
Ustawia obrót znacznika w stopniach w prawo względem jego punktu zakotwiczenia.
Oś obrotu jest prostopadła do znacznika. Obrót o wartości 0 odpowiada domyślnej pozycji znacznika. Animowane.
Jeśli znacznik jest płasko na mapie, jego położenie jest domyślnie wyrównane w kierunku północnym, a obrót odbywa się w taki sposób, że znacznik pozostaje zawsze płasko na mapie. Gdy znacznik ma postać billboardu, jest on ustawiony domyślnie w górę, a obrót jest zawsze skierowany w stronę kamery.
- (liczba zmiennoprzecinkowa) opacity [read, write, assign, inherited] |
Ustawia przezroczystość znacznika w zakresie od 0 (zupełnie przezroczysta) do 1 (domyślna) włącznie.
– Warstwa [read, assign, inherited] (GMSMarkerLayer*) |
Udostępnia warstwę Core Animation dla tego tagu GMSMarker.
– (GMSPanoramaView*) panoramaView [read, write, assign, inherited] |
panoramaView
określa, w którym widoku panoramy będzie wyświetlany ten znacznik.
Pamiętaj, że jeśli położenie (position
) znacznika jest za daleko od bieżącej lokalizacji, w której znajduje się panorama panoramaView
, nie zostanie wyświetlony, ponieważ będzie za mały.
Można ustawić wartość nil, aby usunąć znacznik z dowolnego bieżącego widoku panoramicznego, do którego jest dołączony.
Znacznik może być wyświetlany jednocześnie na panoramie i na mapie.
– (NSString*) title [read, write, copy, inherited] |
Tytuł, krótki opis nakładki.
Niektóre nakładki, na przykład znaczniki, wyświetlają tytuł na mapie. Tytuł jest też domyślnym tekstem ułatwień dostępu.
- (GMSMapView*) mapa [read, write, assign, inherited] |
Mapa, na której znajduje się ta nakładka.
Ustawienie tej właściwości spowoduje dodanie nakładki do mapy. Ustawienie wartości nil powoduje usunięcie tej nakładki z mapy. Nakładka może być w danym momencie aktywna na maksymalnie jednej mapie.
- (BOOL) do kliknięcia [read, write, assign, inherited] |
Jeśli ta nakładka powinna generować powiadomienia o kliknięciach.
Niektóre nakładki, takie jak znaczniki, domyślnie można klikać.
- (int) zIndex [read, write, assign, inherited] |
Nakładki o wyższej wartości zIndex
będą rysowane nad nakładkami i warstwami z kafelkami o niższej wartości zIndex
.
Równe wartości powodują nieokreśloną kolejność rysowania. Wyjątkiem są znaczniki zIndex
, które zawsze są rysowane nad warstwami z kafelkami i innymi nakładkami niebędącymi znacznikami. W praktyce znajdują się w osobnej grupie kolejności nakładania elementów (w porównaniu z innymi nakładkami).
– (identyfikator) userData [read, write, assign, inherited] |
Nakładanie danych.
Możesz użyć tej właściwości do powiązania z tą nakładką dowolnego obiektu. Pakiet SDK Map Google na iOS nie odczytuje ani nie zapisuje tej właściwości.
Pamiętaj, że userData nie powinna zawierać żadnych silnych odwołań do żadnych obiektów Map. W przeciwnym razie może zostać utworzony cykl przechowywania, który uniemożliwi zwolnienie obiektów.