Ikona umieszczona w określonym punkcie na powierzchni mapy. Ikona znacznika jest rysowana zorientacją przylega do ekranu urządzenia, a nie do powierzchni mapy; czyli nie zawsze się zmieni wynikające z obrócenia, przechylenia lub powiększenia mapy.
Znacznik ma te właściwości:
- Alfa
- Ustawia przezroczystość znacznika. Domyślna wartość to 1,0.
- Kotwica
- Punkt na obrazie, który zostanie umieszczony w pozycji
LatLng
znacznika. Domyślnie jest to 50% od lewej i dołu obrazu. - Pozycja
- Wartość
LatLng
określająca pozycję znacznika na mapie. Możesz zmienić tę wartość na w dowolnym momencie, gdy zechcesz przenieść znacznik. - Tytuł
- Ciąg tekstowy wyświetlany w oknie informacyjnym po kliknięciu znacznika przez użytkownika. Dostępne opcje możesz zmienić tę wartość w dowolnym momencie.
- Krótki opis
- Dodatkowy tekst wyświetlany pod tytułem. W każdej chwili możesz zmienić tę wartość.
- Ikona
- Bitmapa wyświetlana dla znacznika. Jeśli zasada jest nieskonfigurowana, domyślną ikoną jest
. Możesz określić inny kolor domyślnej ikony za pomocą parametru
defaultMarker(float)
. - Stan przeciągania
- Jeśli chcesz pozwolić użytkownikowi na przeciąganie znacznika, ustaw tę właściwość na
true
. Ty możesz w każdej chwili zmienić tę wartość. Wartość domyślna tofalse
. - Widoczność
- Domyślnie znacznik jest widoczny. Aby znacznik był niewidoczny, ustaw tę właściwość na
false
W każdej chwili możesz zmienić tę wartość. - Płaski lub billboard
- Jeśli znacznik jest płaski i przytrzymuje się na mapie, aparat pozostanie na nim zablokowany
obraca się i przechyla, ale wciąż pozostaje taki sam jak rozmiar powiększenia (inaczej niż
GroundOverlay
). Jeśli znacznik jest billboardem, zawsze będzie narysowany w stronę aparatu. obraz będzie się obracać i przechylać wraz z kamerą. Domyślnie jest to billboard (false
) . - Obrót
- Obrót znacznika w stopniach w prawo wokół punktu zakotwiczenia znacznika. Oś jest prostopadła do znacznika. Rotacja o wartości 0 odpowiada wartości domyślnej. pozycji znacznika. Jeśli znacznik jest płaski na mapie, domyślną pozycją jest północ. wyrównany i obrót jest taki, że znacznik zawsze pozostaje płaski na mapie. Gdy to billboard, pozycja domyślna jest ustawiona na górę, a obrót jest taki, znacznik jest zawsze skierowany w stronę aparatu. Wartością domyślną jest 0.
- zIndex
- Kolejność rysowania znacznika. Znaczniki są rysowane w kolejności według parametru zIndex, a przy użyciu najwyższy znacznik zIndex narysowany na górze. Ustawiając właściwość zIndex dla każdego znacznika, można kontrolować, który element dotykowy najprawdopodobniej trafi do użytkownika. Wartością domyślną jest 0.
- Tag
- Element
Object
powiązany ze znacznikiem. Na przykładObject
może zawierać na temat tego, co reprezentuje znacznik. To łatwiejsze niż przechowywanie oddzielnego elementuMap<Marker, Object>
. Możesz też powiązać identyfikatorString
. odpowiadający identyfikatorowi ze zbioru danych. Google Maps SDK na Androida nie odczytuje ani nie odczytuje zapisuje tę właściwość.
Metody z tej klasy muszą być wywoływane w wątku interfejsu Androida. W przeciwnym razie w czasie działania zostanie zgłoszone żądanie IllegalStateException
.
Przykład
GoogleMap map = ... // get a map.
// Add a marker at San Francisco.
Marker marker = map.addMarker(new MarkerOptions()
.position(new LatLng(37.7750, 122.4183))
.title("San Francisco")
.snippet("Population: 776733"));
Przewodnik dla programistów
Więcej informacji znajdziesz w witrynie Markers. Google.
Podsumowanie zajęć zagnieżdżonych
@interface | Marker.CollisionBehavior | Wskazuje sposób postępowania ze znacznikiem podczas kolizji z innymi znacznikami lub bazą etykiet map. |
Podsumowanie metody publicznej
wartość logiczna | |
liczba zmiennoprzecinkowa |
getAlpha()
Pobiera wersję alfa znacznika.
|
Ciąg znaków |
getId()
Pobiera identyfikator tego znacznika.
|
LatLng |
getPosition()
Zwraca położenie znacznika.
|
liczba zmiennoprzecinkowa |
getRotation()
Pobiera obrót znacznika.
|
Ciąg znaków |
getSnippet()
Pobiera fragment znacznika.
|
Obiekt |
getTag()
Pobiera tag dla znacznika.
|
Ciąg znaków |
getTitle()
Pobiera tytuł znacznika.
|
liczba zmiennoprzecinkowa |
getZIndex()
Zwraca wartość zIndex znacznika.
|
int, |
hashCode()
|
nieważne |
hideInfoWindow()
Ukrywa okno informacyjne, jeśli jest wyświetlane przed tym znacznikiem.
|
wartość logiczna |
isDraggable()
Pobiera możliwość przeciągania znacznika.
|
wartość logiczna |
isFlat()
Pobiera płaskie ustawienie znacznika.
|
wartość logiczna |
isInfoWindowShown()
Wskazuje, czy okno informacyjne jest obecnie wyświetlane nad tym znacznikiem.
|
wartość logiczna |
isVisible()
Pobiera ustawienie widoczności tego znacznika.
|
nieważne |
remove()
Usuwa ten znacznik z mapy.
|
nieważne |
setAlpha(liczba zmiennoprzecinkowa alfa)
Ustawia poziom alfa (przezroczystość) znacznika.
|
nieważne |
setAnchor(liczba zmiennoprzecinkowa AnchorU, float, AnchorV)
Ustawia punkt zakotwiczenia znacznika.
|
nieważne |
setDraggable(boolean draggable)
Ustawia możliwość przeciągania znacznika.
|
nieważne |
setFlat(wartość logiczna Flat)
Określa, czy znacznik powinien być płasko względem mapy
true , czy billboardu skierowanego do
kamera false . |
nieważne | |
nieważne |
setInfoWindowAnchor(liczba zmiennoprzecinkowa AnchorU, zakotwiczona zmiennoprzecinkowa V)
Określa punkt na obrazie znacznika, w którym ma zostać zakotwiczone okno informacyjne, gdy jest ono
.
|
nieważne | |
nieważne |
setRotation(rotacja zmiennoprzecinkowa)
Ustawia obrót znacznika w stopniach w prawo względem punktu zakotwiczenia znacznika.
|
nieważne |
setSnippet(fragment kodu ciągu)
Ustawia fragment znacznika.
|
nieważne |
setTag(tag obiektu)
Ustawia tag znacznika.
|
nieważne |
setTitle(tytuł ciągu)
Ustawia tytuł znacznika.
|
nieważne |
setVisible(boolean visible)
Ustawia widoczność tego znacznika.
|
nieważne |
setZIndex(liczba zmiennoprzecinkowa zIndex)
Ustawia wartość zIndex znacznika.
|
nieważne |
showInfoWindow()
Wyświetla na mapie okno informacyjne dla tego znacznika, jeśli znacznik
isVisible() . |
Podsumowanie metody dziedziczonej
Metody publiczne
publiczne Wartość logiczna . równa się (inny obiekt)
publiczne liczba zmiennoprzecinkowa . getAlpha ()
Pobiera wersję alfa znacznika.
Zwroty
- alfa znacznika z zakresu [0, 1].
publiczne Ciąg znaków . getId ()
Pobiera identyfikator tego znacznika. Identyfikator będzie unikalny wśród wszystkich znaczników na mapie.
Zwroty
- identyfikator tego znacznika.
publiczne LatLng getPosition ()
Zwraca położenie znacznika.
Zwroty
- Obiekt
LatLng
określający bieżącą pozycję znacznika.
publiczne liczba zmiennoprzecinkowa . getRotation ()
Pobiera obrót znacznika.
Zwroty
- obrót znacznika w stopniach w prawo od pozycji domyślnej.
publiczne Ciąg znaków . getSnippet ()
Pobiera fragment znacznika.
Zwroty
- Ciąg tekstowy zawierający fragment kodu znacznika.
publiczne Obiekt . getTag ()
Pobiera tag dla znacznika.
Zwroty
- tag, jeśli został on skonfigurowany za pomocą atrybutu
setTag
;null
, jeśli nie ustawiono żadnego tagu.
publiczne Ciąg znaków . getTitle ()
Pobiera tytuł znacznika.
Zwroty
- Ciąg tekstowy zawierający tytuł znacznika.
publiczne liczba zmiennoprzecinkowa . getZIndex ()
Zwraca wartość zIndex znacznika.
Zwroty
- zIndex tego znacznika.
publiczne int, . hashCode ()
publiczne nieważne . hideInfoWindow ()
Ukrywa okno informacyjne, jeśli jest wyświetlane przed tym znacznikiem.
Jeśli ten znacznik nie jest widoczny, ta metoda nie działa.
publiczne Wartość logiczna . isDraggable ()
Pobiera możliwość przeciągania znacznika. Gdy znacznik może być przeciągany, użytkownik może go przesunąć przez przytrzymaj naciśnięty znacznik.
Zwroty
true
, jeśli znacznik można przeciągać; w przeciwnym razie zwracafalse
.
publiczne Wartość logiczna . isFlat ()
Pobiera płaskie ustawienie znacznika.
Zwroty
true
, jeśli znacznik jest płaski względem mapy;false
, jeśli znacznik powinien do kamery.
publiczne Wartość logiczna . isInfoWindowShown ()
Wskazuje, czy okno informacyjne jest obecnie wyświetlane nad tym znacznikiem. Nie uwzględnia czy okno informacyjne jest faktycznie widoczne na ekranie.
publiczne Wartość logiczna . isVisible ()
Pobiera ustawienie widoczności tego znacznika. Pamiętaj, że to nie wskazuje, czy znacznik znajduje się w obszarze widocznym na ekranie. Wskazuje, czy znacznik zostanie narysowany, jeśli jest w widocznym obszarze ekranu.
Zwroty
- widoczność tego znacznika.
publiczne nieważne . usuń ()
Usuwa ten znacznik z mapy. Po usunięciu znacznika zachowanie wszystkich jego elementów jest niezdefiniowana.
publiczne nieważne . setAlpha (liczba zmiennoprzecinkowa alfa)
Ustawia poziom alfa (przezroczystość) znacznika. To jest wartość z zakresu od 0 do 1, gdzie 0 oznacza znacznik. oznacza całkowitą przezroczystość, a wartość 1 oznacza, że znacznik jest całkowicie nieprzezroczysty.
Parametry
alfa |
---|
publiczne nieważne . setAnchor (kotwica zmiennoprzecinkowa U, zakotwiczona zmiennoprzecinkowa V)
Ustawia punkt zakotwiczenia znacznika.
Kotwica określa punkt na obrazie ikony, który jest zakotwiczony w pozycji znacznika. na powierzchni Ziemi.
Punkt zakotwiczenia jest określony w postaci 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) – prawy dolny róg. Punkt zakotwiczenia na obrazie (S x wys.) to najbliższy dyskretny punkt siatki w wymiarze (W + 1) x (H + 1) – siatka uzyskana przez skalowanie zgodnie z danym zaokrągleniem. Na przykład w obrazie o wymiarach 4 x 2 punkt zakotwiczenia (0,7; 0,6) przechodzi do punktu siatki w miejscu (3, 1).
*-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----+-----+ | | | X | | (U, V) = (0.7, 0.6) | | | | | *-----+-----+-----+-----* *-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----X-----+ (X, Y) = (3, 1) | | | | | | | | | | *-----+-----+-----+-----*
Parametry
anchorU | współrzędna u reklamy zakotwiczonej jako współczynnik szerokości obrazu (w zakresie [0, 1]). |
---|---|
anchorV | współrzędna v reklamy zakotwiczonej jako współczynnik wysokości obrazu (w zakresie [0, 1]). |
publiczne nieważne . setDraggable (element logiczny do przeciągania)
Ustawia możliwość przeciągania znacznika. Gdy znacznik może być przeciągany, użytkownik może go przesunąć przez przytrzymaj naciśnięty znacznik.
Parametry
przeciągalny |
---|
publiczne nieważne . setFlat (wartość logiczna stała)
Określa, czy znacznik powinien być płasko względem mapy true
, czy billboardu skierowanego do
kamera false
.
Parametry
bez zmian |
---|
publiczne nieważne . setIcon (BitmapDescriptor iconDescriptor)
Ustawia ikonę znacznika.
Parametry
iconDescriptor | Jeśli wartość to null, używany jest znacznik domyślny. |
---|
publiczne nieważne . setInfoWindowAnchor (kotwica zmiennoprzecinkowa U, zakotwiczona zmiennoprzecinkowa V)
Określa punkt na obrazie znacznika, w którym ma zostać zakotwiczone okno informacyjne, gdy jest ono
. Określa się to w tym samym układzie współrzędnych co reklama zakotwiczona. Aby dowiedzieć się więcej, wejdź na setAnchor(float, float)
. Domyślnie wyświetla się ono pośrodku u góry obrazu.
Parametry
anchorU | współrzędna u reklamy zakotwiczonej w oknie informacyjnym, jako współczynnik szerokości obrazu (w tagu zakres [0, 1]). |
---|---|
anchorV | współrzędna v kotwicy okna informacyjnego, jako współczynnik wysokości obrazu (w tagu zakres [0, 1]). |
publiczne nieważne . setRotation (rotacja zmiennoprzecinkowa)
Ustawia obrót znacznika w stopniach w prawo względem punktu zakotwiczenia znacznika. Oś jest prostopadła do znacznika. Obrót równy 0 odpowiada pozycji domyślnej. znacznika.
Parametry
rotacja |
---|
publiczne nieważne . setSnippet (fragment ciągu znaków)
Ustawia fragment znacznika.
Parametry
krótki opis | fragment | Jeśli wartość to null, fragment kodu zostanie wyczyszczony. |
---|
publiczne nieważne . setTag (tag obiektu)
Ustawia tag znacznika.
Za pomocą tej właściwości możesz powiązać z tym znacznikiem dowolne pole Object
. Dla:
Object
może na przykład zawierać dane na temat tego, co reprezentuje znacznik. To łatwiejsze
niż przechowywanie osobnego pliku Map<Marker, Object>
. Innym przykładem może być powiązanie
Identyfikator String
odpowiadający identyfikatorowi ze zbioru danych. Google Maps SDK for Android: brak
odczytuje ani zapisuje tę właściwość. Musisz zadzwonić pod numer setTag(null)
, aby rozwiązać ten problem
tagu, gdy już go nie potrzebujesz, aby zapobiec wyciekom pamięci w aplikacji.
Parametry
tag | Jeśli wartość to null, tag zostanie wyczyszczony. |
---|
publiczne nieważne . setTitle (Tytuł ciągu znaków)
Ustawia tytuł znacznika.
Parametry
tytuł | Jeśli wartość to null, tytuł zostanie wyczyszczony. |
---|
publiczne nieważne . setVisible (wartość logiczna widoczna)
Ustawia widoczność tego znacznika. Jeśli ustawiono wartość false
, a okno informacyjne jest obecnie wyświetlane
dla tego znacznika, spowoduje to ukrycie okna informacyjnego.
Parametry
widoczna |
---|
publiczne nieważne . setZIndex (liczba zmiennoprzecinkowa zIndex)
Ustawia wartość zIndex znacznika.
Parametry
zIndex |
---|
publiczne nieważne . showInfoWindow ()
Wyświetla na mapie okno informacyjne dla tego znacznika, jeśli znacznik isVisible()
.
Rzuty
IllegalArgumentException | jeśli marker nie ma na tej mapie
|
---|