Pisak

publiczne zajęcia końcowe Znacznik rozszerza obiekt

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 to false.
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ład Object może zawierać na temat tego, co reprezentuje znacznik. To łatwiejsze niż przechowywanie oddzielnego elementu Map<Marker, Object>. Możesz też powiązać identyfikator String. 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
równa się(obiekt inny)
Sprawdza, czy ta wartość Marker jest równa innej.
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,
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
setIcon(BitmapDescriptor iconDescriptor)
Ustawia ikonę znacznika.
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
setPosition(LatLngdługość geograficzna)
Ustawia lokalizację znacznika.
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)

Sprawdza, czy ta wartość Marker jest równa innej.

Parametry
inne Object.
Zwroty
  • true (prawda), jeśli oba obiekty są tym samym obiektem, czyli to == inny.

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 zwraca false.

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 . setPosition (LatLng)

Ustawia lokalizację znacznika.

Parametry
dł. geogr.

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