Nowy styl mapy będzie wkrótce dostępny w Google Maps Platform. Ta aktualizacja stylu mapy obejmuje nową domyślną paletę kolorów oraz ulepszenia ułatwiające obsługę i łatwość obsługi map. Wszystkie style mapy zostaną automatycznie zaktualizowane w marcu 2025 r. Więcej informacji o dostępności i sposobie włączania tej funkcji znajdziesz w artykule Nowy styl mapy w Google Maps Platform.

Ta strona została przetłumaczona przez Cloud Translation API.

Opcje znaczników

publiczna klasa końcowy MarkerOptions rozszerza obiekt Object
implementuje Parcelable

Definiuje opcje MarkOptions dla znacznika.

Przewodnik dla programistów

Więcej informacji znajdziesz w przewodniku dla programistów dotyczącym Markers.

Dziedziczone podsumowanie stałych

Z interfejsu android.os.Parcelable

int	CONTENTS_FILE_DESCRIPTOR
int	PARCELABLE_WRITE_RETURN_VALUE

Publiczne podsumowanie konstruktora

MarkerOptions()

Tworzy nowy zestaw opcji znaczników.

Podsumowanie metod publicznych

MarkerOptions	alfa(liczba zmiennoprzecinkowa alfa) Ustawia wartość alfa (przezroczystość) znacznika.
MarkerOptions	kotwica(zmiennoprzecinkowa u, zmiennoprzecinkowa v) Określa kotwicę w określonym punkcie na obrazie znacznika.
MarkerOptions	collisionBehavior(zachowanie zderzenia) Ustawia stan kolizji dla znacznika.
MarkerOptions	draggable(przeciąganie logiczne) Ustawia możliwość przeciągania znacznika.
MarkerOptions	flat(płaska wartość logiczna) Określa, czy ten znacznik powinien znajdować się płasko względem mapy `true` czy billboardu w stronę kamery `false`.
float	getAlpha() Pobiera zestaw alfa dla tego obiektu `MarkerOptions`.
float	getAnchorU(), Odległość w poziomie znormalizowana do [0, 1] od kotwicy od lewej krawędzi.
float	getAnchorV(), Odległość w pionie znormalizowana do [0, 1] od kotwicy od górnej krawędzi.
int	getCollisionBehavior(),
BitmapDescriptor	getIcon() Pobiera niestandardowy deskryptor ikony ustawiony dla tego obiektu `MarkerOptions`.
float	getInfoWindowAnchorU(), Odległość w poziomie znormalizowana do [0, 1] od lewej krawędzi okna informacyjnego.
float	getInfoWindowAnchorV(), Odległość w pionie znormalizowana do [0, 1] od zakotwiczenia okna informacyjnego od górnej krawędzi.
LatLng	getPosition() Zwraca pozycję ustawioną dla tego obiektu `MarkerOptions`.
float	getRotation(), Pobiera zestaw rotacji dla tego obiektu `MarkerOptions`.
Ciąg znaków	getSnippet(), Pobiera fragment kodu dla tego obiektu `MarkerOptions`.
Ciąg znaków	getTitle() Pobiera tytuł ustawiony dla tego obiektu `MarkerOptions`.
float	getZIndex(), Pobiera wartość zIndex ustawioną dla tego obiektu `MarkerOptions`.
MarkerOptions	icon(BitmapDescriptor iconDescriptor) Ustawia ikonę znacznika.
MarkerOptions	infoWindowAnchor(zmiennoprzecinkowa u, zmiennoprzecinkowa v) Określa punkt zakotwiczenia okna informacyjnego na obrazie znacznika.
boolean	isDraggable(), Pobiera ustawienie możliwości przeciągania dla tego obiektu `MarkerOptions`.
boolean	isFlat() Pobiera płaskie ustawienie dla tego obiektu `MarkerOptions`.
boolean	isVisible(), Pobiera ustawienie widoczności tego obiektu `MarkerOptions`.
MarkerOptions	position(LatLng długości) Ustawia lokalizację znacznika.
MarkerOptions	obrót(rotacja zmiennoprzecinkowa) Ustawia obrót znacznika w stopniach w prawo wokół jego punktu zakotwiczenia.
MarkerOptions	snippet(fragment ciągu znaków) Ustawia fragment kodu dla znacznika.
MarkerOptions	title(tytuł ciągu znaków) Ustawia tytuł znacznika.
MarkerOptions	visible(widoczna wartość logiczna) Ustawia widoczność znacznika.
MarkerOptions	zIndex(zIndex z wykorzystaniem zmiennoprzecinkowego) Ustawia wartość zIndex dla znacznika.

Podsumowanie metod dziedziczonych

Z klasy java.lang.Object

boolean	równa się(obiekt arg0)
final Class<?>	getClass()
int	hashCode()
ostateczna unieważnienie	notify()
ostateczna unieważnienie	notifyAll()
Ciąg znaków	toString()
ostateczna unieważnienie	wait(long arg0, int arg1)
ostateczna unieważnienie	wait(long arg0)
ostateczna unieważnienie	wait()

Z interfejsu android.os.Parcelable

abstrakcyjne int	describeContents()
abstrakcyjna pustka	writeToParcel(Parcel arg0, int arg1)

Publiczne konstruktorzy

publiczne MarkerOptions ()

Tworzy nowy zestaw opcji znaczników.

Metody publiczne

public MarkerOptions alfa (liczba zmiennoprzecinkowa alfa)

Ustawia wartość alfa (przezroczystość) znacznika. Należy użyć wartości z zakresu od 0 do 1, gdzie 0 oznacza, że znacznik jest całkowicie przezroczysty, a 1 oznacza, że jest całkowicie nieprzezroczysty.

Parametry

alfa

Akcje powrotne

obiekt, dla którego została wywołana metoda, z nowym zestawem alfa.

public MarkerOptions kotwica (float u, float v)

Określa kotwicę w określonym punkcie na obrazie znacznika.

Kotwica określa punkt na obrazie ikony, który jest zakotwiczony w pozycji znacznika na powierzchni Ziemi.

Punkt zakotwiczenia jest określany jako ciągły odstęp [0,0, 1,0] x [0,0, 1,0], gdzie (0, 0) to lewy górny róg obrazu, a (1, 1) to jego prawy dolny róg. Punkt zakotwiczenia na obrazie W × W to najbliższy dyskretny punkt siatki na siatce (W + 1) x (H + 1). Wynik ten uzyskuje się przez skalowanie, a następnie zaokrąglenie. Na przykład w obrazie o wymiarach 4 × 2 punkt zakotwiczenia (0, 7, 0, 6) przestawia się na punkt siatki w miejscu (3, 1).

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

Parametry

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

Akcje powrotne

obiekt, dla którego wywołano metodę, z nowym zestawem kotwic.

public MarkerOptions collisionBehavior (int collisionBehavior)

Ustawia stan kolizji dla znacznika. To jest wartość Marker.CollisionBehavior. Można go ustawić tylko raz.

Parametry

collisionBehavior

Akcje powrotne

obiekt, dla którego została wywołana metoda z ustawionym stanem kolizji.

public MarkerOptions draggable (boolean draggable)

Ustawia możliwość przeciągania znacznika.

Parametry

przeciągalny

Akcje powrotne

obiekt, dla którego wywołano metodę, z ustawionym nowym stanem możliwego do przeciągania.

public MarkerOptions flat (wartość logiczna płaska)

Określa, czy ten znacznik powinien znajdować się płasko względem mapy true czy billboardu w stronę kamery false. Jeśli znacznik znajduje się płasko względem mapy, pozostanie na mapie podczas obracania i pochylania kamery, ale jej rozmiar pozostanie taki sam jak rozmiar przybliżonej kamery (w przeciwieństwie do GroundOverlay). Jeśli znacznik jest billboardem, będzie zawsze rysowany w kierunku kamery. Będzie się on obracał i pochylał wraz z kamerą. Wartością domyślną jest false.

Parametry

bez zmian

Akcje powrotne

obiekt, dla którego została wywołana metoda, z ustawionym nowym stałym stanem.

public float getAlpha ()

Pobiera zestaw alfa dla tego obiektu MarkerOptions.

Akcje powrotne

wartość alfa znacznika w zakresie [0, 1].

publiczna float getAnchorU ()

Odległość w poziomie znormalizowana do [0, 1] od kotwicy od lewej krawędzi.

Akcje powrotne

wartość u kotwicy.

publiczna float getAnchorV ()

Odległość w pionie znormalizowana do [0, 1] od kotwicy od górnej krawędzi.

Akcje powrotne

wartość v kotwicy.

public int getCollisionBehavior ()

public BitmapDescriptor getIcon ()

Pobiera niestandardowy deskryptor ikony ustawiony dla tego obiektu MarkerOptions.

Akcje powrotne

Wartość BitmapDescriptor reprezentująca ikonę niestandardową lub null, jeśli nie ustawiono ikony niestandardowej.

publiczna float getInfoWindowAnchorU ()

Odległość w poziomie znormalizowana do [0, 1] od lewej krawędzi okna informacyjnego.

Akcje powrotne

wartość u kotwicy okna informacyjnego.

publiczna float getInfoWindowAnchorV ()

Odległość w pionie znormalizowana do [0, 1] od zakotwiczenia okna informacyjnego od górnej krawędzi.

Akcje powrotne

wartość v kotwicy okna informacyjnego.

public LatLng getPosition ()

Zwraca pozycję ustawioną dla tego obiektu MarkerOptions.

Akcje powrotne

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

public float getRotation ()

Pobiera zestaw rotacji dla tego obiektu MarkerOptions.

Akcje powrotne

obrót znacznika od pozycji domyślnej o stopnie w prawo.

public String getSnippet ()

Pobiera fragment kodu dla tego obiektu MarkerOptions.

Akcje powrotne

Ciąg tekstowy zawierający fragment kodu znacznika.

public String getTitle ()

Pobiera tytuł ustawiony dla tego obiektu MarkerOptions.

Akcje powrotne

Ciąg tekstowy zawierający tytuł znacznika.

public float getZIndex ()

Pobiera wartość zIndex ustawioną dla tego obiektu MarkerOptions.

Akcje powrotne

wartości zIndex znacznika.

public MarkerOptions ikona (BitmapDescriptor iconDescriptor)

Ustawia ikonę znacznika.

Parametry

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

Akcje powrotne

obiekt, dla którego została wywołana metoda z ustawionym deskryptorem nowej ikony.

public MarkerOptions infoWindowAnchor (float u, float v)

Określa punkt zakotwiczenia okna informacyjnego na obrazie znacznika. Jest ona określona w tym samym układzie współrzędnych co kotwica. Więcej informacji: anchor(float, float). Domyślnie znajduje się on na środku u góry.

Parametry

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

Akcje powrotne

obiekt, dla którego została wywołana metoda, z ustawioną nową kotwicą okna informacyjnego.

public boolean isDraggable ()

Pobiera ustawienie możliwości przeciągania dla tego obiektu MarkerOptions.

Akcje powrotne

true, jeśli znacznik można przeciągać. W przeciwnym razie zwraca wartość false.

public boolean isFlat ()

Pobiera płaskie ustawienie dla tego obiektu MarkerOptions.

Akcje powrotne

true, jeśli znacznik znajduje się płasko względem mapy; false, jeśli znacznik powinien być zwrócony w stronę aparatu.

public boolean isVisible ()

Pobiera ustawienie widoczności tego obiektu MarkerOptions.

Akcje powrotne

true, jeśli znacznik jest widoczny. W przeciwnym razie zwraca false.

public MarkerOptions position (LatLng latlng)

Ustawia lokalizację znacznika.

Parametry

latlng

Akcje powrotne

obiekt, dla którego została wywołana metoda, z nowym ustawieniem pozycji.

public MarkerOptions obrót (obrót zmiennoprzecinkowy)

Ustawia obrót znacznika w stopniach w prawo wokół jego punktu zakotwiczenia. Oś obrotu jest prostopadła do znacznika. Rotacja o wartości 0 odpowiada domyślnej pozycji znacznika. Gdy znacznik znajduje się płasko na mapie, domyślnie jest wyrównany do północy, a obrót jest przy tym, że znacznik zawsze pozostaje płasko na mapie. Gdy znacznik jest ustawiony na billboard, jego domyślna pozycja jest skierowana do góry, a obrót jest ustawiony tak, że jest zawsze skierowany w stronę kamery. Wartością domyślną jest 0.

Parametry

rotacja

Akcje powrotne

obiekt, dla którego została wywołana metoda, z nowym zestawem rotacji.

public MarkerOptions fragment (fragment ciągu)

Ustawia fragment kodu dla znacznika.

Parametry

krótki opis \| fragment

Akcje powrotne

obiekt, dla którego została wywołana metoda, z ustawionym nowym fragmentem.

public MarkerOptions title (tytuł ciągu)

Ustawia tytuł znacznika.

Parametry

title

Akcje powrotne

obiekt, dla którego została wywołana metoda, z nowym tytułem.

public MarkerOptions visible (boolean visible)

Ustawia widoczność znacznika.

Parametry

widoczna

Akcje powrotne

obiekt, dla którego została wywołana metoda z ustawionym nowym stanem widoczności.

public MarkerOptions zIndex (float zIndex)

Ustawia wartość zIndex dla znacznika.

Parametry

zIndex

Akcje powrotne

obiekt, dla którego została wywołana metoda, z nowym zestawem zIndex.