Pisak

publiczna klasa najwyższego poziomu Marker rozszerza obiekt

Ikona umieszczona w określonym punkcie na mapie. Ikona znacznika jest nakierowana w kierunku ekranu urządzenia, a nie na mapę, tj. nie musi zmieniać orientacji ze względu na obrót mapy, jej pochylenie lub powiększenie.

Znacznik ma następujące właściwości:

Alfa
Ustaw przezroczystość znacznika. Domyślna wartość to 1.0.
Kotwica
Punkt na obrazie, który zostanie umieszczony w pozycji LatLng znacznika. Wartość domyślna to 50% od jego lewej i dolnej części obrazu.
Pozycja
Wartość LatLng w znaczniku na mapie. Jeśli chcesz przenieść znacznik, możesz w każdej chwili zmienić tę wartość.
Stanowisko
Ciąg tekstowy wyświetlany w oknie informacyjnym po kliknięciu znacznika. Możesz ją zmienić w każdej chwili.
Fragment
Dodatkowy tekst wyświetlany pod tytułem. Możesz ją zmienić w każdej chwili.
Ikona
Mapa bitowa, którą ma wyświetlić się znacznik. Jeśli ikona nie jest skonfigurowana, wyświetlana jest ikona domyślna. Aby określić alternatywny kolor ikony domyślnej, użyj defaultMarker(float).
Stan przeciągania
Jeśli chcesz zezwolić użytkownikowi na przeciąganie znacznika, ustaw tę właściwość na true. Możesz ją zmienić w każdej chwili. Wartość domyślna to false.
Widoczność
Domyślnie znacznik jest widoczny. Aby znacznik był niewidoczny, ustaw tę właściwość na false. Możesz ją zmienić w każdej chwili.
Płaski lub billboard
Jeśli znacznik będzie płasko na mapie, pozostanie w tym miejscu, gdy aparat się obraca i przechyla, ale pozostaje taki sam jak rozmiar powiększenia, w przeciwieństwie do wartości GroundOverlay. Jeśli znacznik znajduje się na billboardzie, jest zawsze rysowany skierowanym w stronę kamery. Obrócisz się wraz z kamerą, Wartość domyślna to billboard (false).
Rotacja
Obróć znacznik w stopniach w prawo o punkt zakotwiczenia znacznika. Oś obrotu jest prostopadła do znacznika. Rotacja 0 odpowiada domyślnej pozycji znacznika. Kiedy znacznik jest płaski na mapie, domyślna pozycja jest wyrównana a obrót będzie zawsze płaski. Gdy znacznik jest billboardem, pozycja domyślna jest skierowana w górę, a obrót odbywa się tak, że znacznik jest zawsze skierowany do aparatu. Wartością domyślną jest 0.
Kolejność nakładania elementów
Kolejność rysowania znacznika. Znaczniki są rysowane w kolejności kolejności nakładania elementów, a najwyższy – Kolejność nakładania. Ustawiając właściwość zindex dla każdego znacznika, możesz kontrolować, które elementy dotykowe mają największe szanse na dotarcie przez użytkownika. Wartością domyślną jest 0.
Tag
Object powiązane ze znacznikiem. Object może na przykład zawierać dane o tym, co reprezentuje znacznik. To łatwiejsze niż przechowywanie osobnego pliku 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 zapisuje tej właściwości.

Metody w tej klasie muszą być wywoływane w wątku UI Androida. Jeśli nie, w trakcie działania zostanie wywołany 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 przewodniku dla programistów Markers.

Podsumowanie zagnieżdżonych zajęć

@interfejs Marker.CollisionZachowanie Wskazuje sposób obsługi znacznika, gdy wystąpi kolizja z innymi znacznikami lub etykietami map podstawowych. 

Podsumowanie metody publicznej

wartość logiczna
równa się (inny obiekt)
Sprawdza, czy to Marker ma wartość inną.
liczba zmiennoprzecinkowa
getAlpha
Pobiera wersję alfa znacznika.
Ciąg znaków
getId()
Pobiera identyfikator tego znacznika.
LatLng
getPosition()
Zwraca pozycję znacznika.
liczba zmiennoprzecinkowa
getRotation()
Pobiera obrót znacznika.
Ciąg znaków
getSnippet
Pobiera fragment znacznika.
Obiekt
getTag()
Pobiera tag znacznika.
Ciąg znaków
getTitle()
Pobiera tytuł znacznika.
liczba zmiennoprzecinkowa
getZIndex
Zwraca wartość kolejności nakładania elementów.
int,
nieważne
hideInfoWindow()
Powoduje ukrycie okna informacyjnego ze znacznika.
wartość logiczna
is Draggable()
Pobiera znacznik.
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
usuń()
Usuwa ten znacznik z mapy.
nieważne
setAlpha (liczba zmiennoprzecinkowa)
Ustawia alfa (przezroczystość) znacznika.
nieważne
setAnchor(liczba zmiennoprzecinkowa zakotwiczenia U, pływająca kotwica V)
Ustawia punkt zakotwiczenia znacznika.
nieważne
set Draggable(wartość logiczna do przeciągania)
Ustawia przeciąganie znacznika.
nieważne
setFlat(wartość logiczna „płaska”)
Określa, czy znacznik powinien być płasko na mapie true, czy na billboardzie skierowanym do kamery false.
nieważne
setIcon (deskryptor ikony BitmapDescriptor)
Ustawia ikonę znacznika.
nieważne
setInfoWindowAnchor (zakotwiczona kreacja zakotwiczona U, zakotwiczona kreacja pływającaV)
Określa punkt na obrazie znacznika, w którym należy zakotwiczyć wyświetlane okno informacyjne.
nieważne
setPosition(LatLng – szerokość)
Ustawia lokalizację znacznika.
nieważne
setRotation (obrót liczby zmiennoprzecinkowej)
Ustawia obrót znacznika w stopniach w prawo wokół punktu zakotwiczenia znacznika.
nieważne
setSnippet(fragment ciągu)
Ustawia fragment kodu znacznika.
nieważne
setTag(tag obiektu)
Ustawia tag znacznika.
nieważne
setTitle(tytuł ciągu znaków)
Ustawia tytuł znacznika.
nieważne
setVisible(wartość logiczna)
Ustawia widoczność tego znacznika.
nieważne
setZIndex (liczba zmiennoprzecinkowa)
Ustawia wartość zindex znacznika.
nieważne
showInfoWindow()
Pokazuje na mapie okno informacyjne tego znacznika, jeśli ten znacznik isVisible() jest aktywny.

Podsumowanie metody dziedziczonej

Metody publiczne

publiczna wartość logiczna równa się(inny obiekt)

Sprawdza, czy to Marker ma wartość inną.

Parametry
inne Object.
Zwraca
  • true (prawda), jeśli oba obiekty są tym samym obiektem (to jest wartość == other).

publiczna zmiennoprzecinkowa getAlpha ()

Pobiera wersję alfa znacznika.

Zwraca
  • alfa znacznika zakresu [0, 1].

publiczny Ciąg getId ()

Pobiera identyfikator tego znacznika. Identyfikator będzie unikalny wśród wszystkich znaczników na mapie.

Zwraca
  • ten znacznik.

publiczne LatLng getPosition ()

Zwraca pozycję znacznika.

Zwraca
  • Obiekt LatLng określający bieżącą pozycję znacznika.

publiczna liczba zmiennoprzecinkowa getRotation()

Pobiera obrót znacznika.

Zwraca
  • obróć znacznik w stopniach w prawo od domyślnej pozycji.

Publiczny Ciąg getSnippet ()

Pobiera fragment znacznika.

Zwraca
  • Ciąg zawierający fragment znacznika.

obiekt publiczny getTag ()

Pobiera tag znacznika.

Zwraca
  • tag, jeśli tag został ustawiony na setTag. Jeśli nie został on ustawiony, null.

publiczny ciąg getTitle ()

Pobiera tytuł znacznika.

Zwraca
  • Ciąg zawierający tytuł znacznika.

publiczna liczba zmiennoprzecinkowa getZIndex()

Zwraca wartość kolejności nakładania elementów.

Zwraca
  • ten znacznik ZIndex.

public int hashCode ()

void void hideInfoWindow ()

Powoduje ukrycie okna informacyjnego ze znacznika.

Jeśli ten znacznik nie jest widoczny, ta metoda nie ma skutków.

publiczna wartość logiczna is Draggable ()

Pobiera znacznik. Znacznik można przesunąć, przesuwając użytkownika po długim naciśnięciu.

Zwraca
  • true, jeśli znacznik można przeciągnąć. W przeciwnym razie zwraca false.

publiczna wartość logiczna isFlat()

Pobiera płaskie ustawienie znacznika.

Zwraca
  • true, jeśli znacznik jest płasko na mapie, a false, jeśli znacznik powinien być zwrócony do aparatu.

public boolean isInfoWindowShown ()

Wskazuje, czy okno informacyjne jest obecnie wyświetlane nad tym znacznikiem. Nie ma znaczenia, czy okno informacyjne będzie widoczne na ekranie.

publiczna wartość logiczna isVisible ()

Pobiera ustawienie widoczności tego znacznika. Pamiętaj, że nie wskazuje to, czy znacznik znajduje się w widocznym obszarze ekranu. Wskazuje, czy znacznik jest widoczny, jeśli znajduje się w widocznym obszarze ekranu.

Zwraca
  • Widoczność tego znacznika.

void usuń ()

Usuwa ten znacznik z mapy. Po usunięciu znacznika działanie wszystkich jego metod jest niezdefiniowane.

void void setalpha (float alfa)

Ustawia alfa (przezroczystość) znacznika. Wartość od 0 do 1 oznacza, że 0 oznacza, że znacznik jest całkowicie przezroczysty, a 1 oznacza, że jest całkowicie nieprzezroczysty.

Parametry
alfa

void void setAnchor (floating AnchorU, float AnchorV)

Ustawia punkt zakotwiczenia znacznika.

Kotwica określa punkt na obrazie ikony zakotwiczony na pozycji znacznika na powierzchni Ziemi.

Punkt zakotwiczenia jest określony w ciągłym przedziale [0,0, 1,0] x [0,0, 1,0], gdzie (0, 0) to lewy górny róg obrazu, a (1, 1) to prawy dolny róg. Punkt zakotwiczenia na obrazie W x H to najbliższy oddzielny punkt siatki na siatce (W + 1) x (H + 1) uzyskane przez skalowanie, a następnie zaokrąglanie. Na przykład na obrazie 4 x 2 punkt zakotwiczenia (0, 7, 0, 6) przechodzi do punktu siatki na pozycji (3, 1).

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----X-----+   (X, Y) = (3, 1)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*
 

Parametry
kotwica U współrzędna u kotwicy jako współczynnik szerokości obrazu (w zakresie [0, 1]).
kotwica V współrzędna v kotwicy jako współczynnik wysokości obrazu (w zakresie [0, 1]).

void voidset Draggable(wartość logiczna przeciągania)

Ustawia przeciąganie znacznika. Znacznik można przesunąć, przesuwając użytkownika po długim naciśnięciu.

Parametry
przeciągalny

void void setFlat (wartość logiczna płaski)

Określa, czy znacznik powinien być płasko na mapie true, czy na billboardzie skierowanym do kamery false.

Parametry
bez zmian

void void setIcon (BitmapDescriptor iconDescriptor)

Ustawia ikonę znacznika.

Parametry
Ikonadeskryptor jeśli ma wartość null, jest używany domyślny znacznik.

void void setInfoWindowAnchor (float AnchorU, float AnchorV)

Określa punkt na obrazie znacznika, w którym należy zakotwiczyć wyświetlane okno informacyjne. Określa się w tym samym systemie współrzędnych co kotwica. Więcej informacji: setAnchor(float, float). Wartość domyślna to górny środek obrazu.

Parametry
kotwica U współrzędna u kotwicy okna informacyjnego jako współczynnik szerokości obrazu (w zakresie [0, 1]).
kotwica V współrzędna v kotwicy okna informacyjnego jako współczynnik wysokości obrazu (w zakresie [0, 1]).

void voidsetPosition(LatLng)

Ustawia lokalizację znacznika.

Parametry
Latlng

void voidsetRotation(obrót liczby zmiennoprzecinkowej)

Ustawia obrót znacznika w stopniach w prawo wokół punktu zakotwiczenia znacznika. Oś obrotu jest prostopadła do znacznika. Rotacja 0 odpowiada domyślnej pozycji znacznika.

Parametry
obrót

void void setSnippet (ciąg znaków)

Ustawia fragment kodu znacznika.

Parametry
fragment|kawałek [kodu] Jeśli wartość null, fragment jest pusty.

void void setTag (tag obiektu)

Ustawia tag znacznika.

Możesz użyć tej właściwości, aby powiązać z tym znacznikiem dowolny Object. Object może na przykład zawierać dane o tym, co reprezentuje znacznik. To łatwiejsze niż przechowywanie osobnego pliku 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 zapisuje tej właściwości. Twoim obowiązkiem jest wywoływanie tagu setTag(null), gdy nie potrzebujesz go już, aby zapobiec wyciekom pamięci w aplikacji.

Parametry
tag Jeśli jest null, tag zostanie usunięty.

void void setTitle (ciąg znaków)

Ustawia tytuł znacznika.

Parametry
tytuł Jeśli wartość null, tytuł został wyczyszczony.

void void setVisible (wartość logiczna widoczna)

Ustawia widoczność tego znacznika. Jeśli jest ustawiona na false, a przy tym znaczniku wyświetla się okno informacyjne, to okno zostanie ukryte.

Parametry
widoczna

void void setZIndex (float zIndex)

Ustawia wartość zindex znacznika.

Parametry
Kolejność nakładania elementów

void void showInfoWindow ()

Pokazuje na mapie okno informacyjne tego znacznika, jeśli ten znacznik isVisible() jest aktywny.

Narzuty
Wyjątek związany z nielegalnym zabezpieczeniem Jeśli to miejsce (marker) nie znajduje się na tej mapie