Dokumentacja klasy GMSMarker

Odniesienie do klasy GMSMarker

Opis

Znacznik to ikona umieszczona w określonym punkcie na powierzchni mapy.

Ikona znacznika jest rysowana zgodnie z położeniem względem ekranu urządzenia, a nie powierzchni mapy, tj. nie musi zmieniać orientacji w wyniku jej obrotu, przechylenia lub powiększenia.

Dziedziczy GMSOverlay.

Odziedziczone przez GMSAdvancedMarker.

Statyczne publiczne funkcje członkowskie

(typ instancji)+ markerWithPosition:
 Wygodny konstruktor znacznika domyślnego.
(Grafika UI *)+ markerImageWithColor:
 Tworzy zabarwioną wersję domyślnego obrazu znacznika do użycia jako ikony.

Usługi

CLLocationCoordinate2Dposition
 Pozycja znacznika.
NSString * fragment tekstu
 Krótki opis wyświetlany pod tytułem w oknie informacyjnym po wybraniu.
UIImage * ikona
 Ikona znacznika do wyrenderowania.
UIView * iconView
 Widok znacznika do wyrenderowania.
BOOLtracksViewChanges
 Określa, czy ikona tego znacznika ma być ponownie rysowana w każdej klatce.
BOOLtracksInfoWindowChanges
 Określa, czy okno informacyjne tego znacznika ma być ponownie rysowane po każdej klatce.
CGPointgroundAnchor
 Kotwica podstawy określa punkt na obrazie ikony, który jest zakotwiczony w pozycji znacznika na powierzchni Ziemi.
CGPointinfoWindowAnchor
 Kotwica okna informacyjnego określa punkt na obrazie ikony, w którym ma być zakotwiczone okno informacyjne wyświetlane bezpośrednio nad tym punktem.
GMSMarkerAnimationappearAnimation
 Określa animację używaną po umieszczeniu tego znacznika w obiekcie GMSMapView (domyślna wartość kGMSMarkerAnimationNone, brak animacji).
BOOLprzeciągany
 Określa, czy ten znacznik można przeciągać interaktywnie (domyślnie NIE).
BOOLpłaski
 Określa, czy ten znacznik powinien znajdować się płasko względem powierzchni Ziemi (TAK) czy w stronę billboardu w stronę kamery (wartość NIE, domyślna).
CLLocationDegrsrotacja
 Ustawia obrót znacznika w stopniach w prawo wokół jego punktu zakotwiczenia.
float opacity
 Ustawia przezroczystość znacznika od 0 (całkowicie przezroczysta) do 1 (domyślna) włącznie.
GMSMarkerLayerWarstwa
 Udostępnia warstwę Core Animation dla tej funkcji GMSMarker.
GMSPanoramaViewpanoramaView
 panoramaView określa, w którym widoku panoramy będzie wyświetlany ten znacznik.
NSString * title
 Tytuł, krótki opis nakładki.
GMSMapViewmapa
 Mapa, na której znajduje się ta nakładka.
BOOLklikalny
 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 warstwami kafelków i nakładkami o niższej wartości zIndex.
id [identyfikator]userData
 Nakładanie danych.

Dokumentacja funkcji członka grupy

+ (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 właściwości

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

Pozycja znacznika.

Animowane.

– (NSString*) fragment [read, write, copy]

Krótki opis wyświetlany pod tytułem w oknie informacyjnym po wybraniu.

ikona [read, write, assign] (UIImage*)

Ikona znacznika do wyrenderowania.

Jeśli pozostawisz wartość nil, używany jest domyślny znacznik miejsca SDK.

Obsługuje animowane obrazy, ale każda klatka musi mieć ten sam rozmiar, w przeciwnym razie zachowanie jest nieokreślone.

Obsługuje użycie wyrównaniaRectInsets do określania zmniejszonego obszaru kliknięcia. Zmienia też sposób określania kotwic. W przypadku animowanego obrazu używana jest wartość animacji, a nie pojedynczych klatek.

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

Widok znacznika do wyrenderowania.

Jeśli pozostawisz wartość nil, zamiast tego używana jest 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 jego rzeczywistej wartości.

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

Określa, czy ikona tego znacznika ma być ponownie rysowana w każdej klatce.

Pamiętaj, że gdy ta opcja zmieni się z NIE na TAK, ikona zostanie za każdym razem utworzona ponownie.

Domyślna wartość to YES (TAK). Nie ma zastosowania, jeśli iconView ma wartość zerową.

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

Określa, czy okno informacyjne tego znacznika ma być ponownie rysowane po każdej klatce.

Pamiętaj, że gdy ta opcja zostanie zmieniona z NIE na TAK, okno informacyjne zawsze zostanie wyświetlone ponownie.

Wartość domyślna to NO.

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

Kotwica podstawy określa punkt na obrazie ikony, który jest zakotwiczony w pozycji znacznika na powierzchni Ziemi.

Ten punkt jest określany na ciągłej przestrzeni [0,0; 1,0] x [0,0; 1,0], gdzie (0,0) to lewy górny róg zdjęcia, a (1,1) to prawy dolny róg zdjęcia.

Jeśli opcja wyrównania obrazu ma wartość inną niż zero, lewy górny i prawy dolny róg obrazu wspomniany powyżej odnosi się do sekcji obrazu wstawionej.

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

Kotwica okna informacyjnego określa punkt na obrazie ikony, w którym ma być 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]

Określa animację używaną po umieszczeniu tego znacznika w obiekcie GMSMapView (domyślna wartość kGMSMarkerAnimationNone, brak animacji).

- (BOOL) przeciągalna [read, write, assign]

Określa, czy ten znacznik można przeciągać interaktywnie (domyślnie NIE).

- (BOOL) płaski [read, write, assign]

Określa, czy ten znacznik powinien znajdować się płasko względem powierzchni Ziemi (TAK) czy w stronę billboardu w stronę kamery (wartość NIE, domyślna).

- (CLLocationDegrs) obrót [read, write, assign]

Ustawia obrót znacznika w stopniach w prawo wokół jego punktu zakotwiczenia.

Oś obrotu jest prostopadła do znacznika. Wartość obrotu o wartości 0 odpowiada domyślnej pozycji znacznika. Animowane.

Gdy znacznik jest położony płasko na mapie, domyślnie jest wyrównana na północ, a obrót jest przy tym, że znacznik zawsze pozostaje płasko na mapie. Gdy znacznik ma postać billboardu, jego domyślna pozycja jest skierowana do góry, a jego obrót jest zawsze skierowany w stronę kamery.

- (liczba zmiennoprzecinkowa) przezroczystość [read, write, assign]

Ustawia przezroczystość znacznika od 0 (całkowicie przezroczysta) do 1 (domyślna) włącznie.

- (GMSMarkerLayer*) warstwa [read, assign]

Udostępnia warstwę Core Animation dla tej funkcji GMSMarker.

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

panoramaView określa, w którym widoku panoramy będzie wyświetlany ten znacznik.

Pamiętaj, że jeśli znacznik (position) znajduje się zbyt daleko od bieżącej lokalizacji panoramy panoramaView, nie zostanie wyświetlony, ponieważ będzie za mały.

Można usunąć znacznik z bieżącego widoku panoramy, 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, takie jak znaczniki, wyświetlają tytuł na mapie. Tytuł jest też domyślnym tekstem dotyczącym 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 tylko na 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 kliknąć.

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

Nakładki o wyższej wartości zIndex będą rysowane nad warstwami kafelków i nakładkami o niższej wartości zIndex.

Równe wartości powodują nieokreśloną kolejność rysowania. Znaczniki są wyjątkiem. Bez względu na wartość zIndex są zawsze rysowane nad warstwami kafelków i innymi nakładkami niebędącymi znacznikami; w praktyce są uznawane za znajdujące 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.

Za pomocą tej właściwości możesz powiązać dowolny obiekt z tą nakładką. Google Maps SDK na iOS nie odczytuje ani nie zapisuje tej właściwości.

Pamiętaj, że parametr userData nie powinien zawierać żadnych silnych odniesień do obiektów Map Google. W przeciwnym razie może wystąpić cykl przechowywania (co zapobiegnie zwolnieniu obiektów).