Przegląd
Znacznik to ikona umieszczona w konkretnym punkcie na powierzchni mapy.
Ikona znacznika jest rysowana z orientacją względem ekranu urządzenia, a nie powierzchni mapy. Oznacza to, że nie zawsze zmienia orientację w wyniku obrotów, przechylania lub powiększania mapy.
Dziedziczy GMSOverlay.
Odziedziczony przez GMSAdvancedMarker.
Statyczne publiczne funkcje członków | |
| (typ instancji) | + markerWithPosition: |
| Wygodny konstruktor znacznika domyślnego. | |
| (UIImage *) | + markerImageWithColor: |
| Tworzy zabarwioną wersję domyślnego obrazu znacznika do wykorzystania jako ikonę. | |
Usługi | |
| CLLocationCoordinate2D | position |
| Pozycja znacznika. | |
| NSString * | krótki opis |
| Fragment tekstu wyświetlany pod tytułem w oknie informacyjnym po wybraniu. | |
| UIImage * | ikona |
| Ikona znacznika do renderowania. | |
| UIView * | iconView. |
| Widok znacznika do renderowania. | |
| BOOL | tracksViewChanges |
| Określa, czy ikona tego znacznika ma być ponownie rysowana w każdej klatce. | |
| BOOL | tracksInfoWindowChanges |
| Określa, czy okno informacyjne dla tego znacznika ma być ponownie rysowane dla każdej klatki. | |
| CGPoint | zakotwiczenie ziemi |
| 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 | showAnimation |
| Określa animację używaną po umieszczeniu tego znacznika w elemencie GMSMapView (domyślnie kGMSMarkerAnimationNone, brak animacji). | |
| BOOL | przeciągalny |
| Określa, czy ten znacznik można interaktywnie przeciągać (domyślnie NIE). | |
| BOOL | stałe |
| Określa, czy ten znacznik powinien być płaski względem powierzchni Ziemi (TAK) czy billboardu w kierunku kamery (NIE, opcja domyślna). | |
| CLLocationStopnie, | rotacja |
| Ustawia obrót znacznika w stopniach w prawo względem jego punktu zakotwiczenia. | |
| liczba zmiennoprzecinkowa | opacity. |
| Ustawia przezroczystość znacznika w zakresie 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 ma być wyświetlany ten znacznik. | |
| NSString * | title |
| Tytuł, krótki opis nakładki. | |
| GMSMapView * | mapa |
| Mapa, na której znajduje się ta nakładka. | |
| BOOL | do kliknięcia |
| Jeśli ta nakładka powinna generować powiadomienia dotykowe. | |
| int, | zIndex, |
Nakładki o wyższej wartości zIndex będą rysowane na warstwach i nakładkach 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: | (dopuszczalna wartość UIColor *) | color [kolor] |
Tworzy zabarwioną wersję domyślnego obrazu znacznika do wykorzystania jako ikonę.
Dokumentacja właściwości
– pozycja [read, write, assign] (CLLocationCoordinate2D) |
Pozycja znacznika.
Animowane.
– (NSString*) fragment [read, write, copy] |
Fragment tekstu wyświetlany pod tytułem w oknie informacyjnym po wybraniu.
- ikona [read, write, assign] (UIImage*) |
Ikona znacznika do renderowania.
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, w przeciwnym razie działanie jest nieokreślone.
Obsługuje użycie wyrównaniaRectInsets do określenia zmniejszonego obszaru kliknięcia. Spowoduje to też zmianę sposobu określania kotwic. W przypadku animowanego obrazu używana jest wartość animacji, a nie poszczególnych klatek.
– (UIView*) iconView [read, write, assign] |
Widok znacznika do renderowania.
Jeśli pozostawisz wartość nil, przełączy się na właściwość icon.
Obsługuje animacje wszystkich możliwych do animacji właściwości UIView z wyjątkiem frame i center. Zmiana tych właściwości ani odpowiadającej 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 faktycznej 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 na pewno zostanie ponownie wyświetlona w następnej klatce.
Wartość domyślna to TAK. Nie ma żadnego efektu, jeśli iconView ma wartość zerową.
- (BOOL) tracksInfoWindowChanges [read, write, assign] |
Określa, czy okno informacyjne dla tego znacznika ma być ponownie rysowane dla każdej klatki.
Pamiętaj, że gdy to ustawienie zmieni się z NIE na TAK, okno informacyjne na pewno zostanie ponownie wyświetlone w następnej klatce.
Wartość domyślna to NIE.
- (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 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 zdjęcia, a (1,1) to prawy dolny róg.
Jeśli wartości wyrównania mają wartość inną niż zero, wymienione powyżej lewy górny i prawy dolny róg obrazu odnoszą 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 elemencie GMSMapView (domyślnie kGMSMarkerAnimationNone, brak animacji).
- (BOOL) przeciągany [read, write, assign] |
Określa, czy ten znacznik można interaktywnie przeciągać (domyślnie NIE).
- (BOOL) płaski [read, write, assign] |
Określa, czy ten znacznik powinien być płaski względem powierzchni Ziemi (TAK) czy billboardu w kierunku kamery (NIE, opcja domyślna).
– rotacja [read, write, assign] (CLLocationDerations) |
Ustawia obrót znacznika w stopniach w prawo względem jego punktu zakotwiczenia.
Oś obrotu jest prostopadła do znacznika. Wartość obrót o wartości 0 odpowiada domyślnej pozycji znacznika. Animowane.
Gdy znacznik jest płasko na mapie, domyślne położenie jest wyrównane na północ, a obrót jest taki, że znacznik zawsze pozostaje płasko na mapie. Gdy znacznik ma postać billboardu, jego domyślne położenie jest ustawione w górę, a obrót jest taki, że znacznik jest zawsze skierowany w stronę kamery.
- (liczba zmiennoprzecinkowa) krycie [read, write, assign] |
Ustawia przezroczystość znacznika w zakresie 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 ma być wyświetlany ten znacznik.
Pamiętaj, że jeśli position znacznika będzie za daleko od bieżącej lokalizacji panoramy panoramaView, nie wyświetli się, ponieważ będzie za mały.
Można ustawić na nil wartość nil, aby 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ły 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 dotykowe.
Niektóre nakładki, takie jak znaczniki, będą domyślnie dostępne do kliknięcia.
- (int) zIndex [read, write, assign, inherited] |
Nakładki o wyższej wartości zIndex będą rysowane na warstwach i nakładkach 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 porównaniu z innymi nakładkami są uznawane za znajdujące się w osobnej grupie kolejności nakładania elementów.
- (identyfikator) userData [read, write, assign, inherited] |
Nakładanie danych.
Za pomocą tej właściwości możesz powiązać dowolny obiekt z daną 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 wyraźnych odniesień do obiektów Map Google. W przeciwnym razie może zostać utworzony cykl przechowywania, który uniemożliwi zwolnienie obiektów.