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 | |
CLLocationCoordinate2D | position |
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. | |
BOOL | tracksViewChanges |
Określa, czy ikona tego znacznika ma być ponownie rysowana w każdej klatce. | |
BOOL | tracksInfoWindowChanges |
Określa, czy okno informacyjne tego znacznika ma być ponownie rysowane po każdej klatce. | |
CGPoint | groundAnchor |
Kotwica podstawy określa punkt na obrazie ikony, który jest zakotwiczony w pozycji znacznika na powierzchni Ziemi. | |
CGPoint | infoWindowAnchor |
Kotwica okna informacyjnego określa punkt na obrazie ikony, w którym ma być zakotwiczone okno informacyjne wyświetlane bezpośrednio nad tym punktem. | |
GMSMarkerAnimation | appearAnimation |
Określa animację używaną po umieszczeniu tego znacznika w obiekcie GMSMapView (domyślna wartość 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 znajdować się płasko względem powierzchni Ziemi (TAK) czy w stronę billboardu w stronę kamery (wartość NIE, domyślna). | |
CLLocationDegrs | rotacja |
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. | |
GMSMarkerLayer * | Warstwa |
Udostępnia warstwę Core Animation dla tej funkcji 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 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).