Marker (legacy)

Marker class

google.maps.Marker zajęcia

Wycofane: 21 lutego 2024 r. wycofaliśmy znacznik google.maps.Marker. Zamiast nich użyj kolumn: AdvancedMarkerElement. Obecnie nie planujemy wycofania znacznika google.maps.Marker, ale zalecamy używanie elementu AdvancedMarkerElement zamiast niego. Znacznik google.maps.Marker będzie nadal otrzymywać poprawki błędów w przypadku poważnych regresji, ale istniejące błędy w tym znaczniku nie będą usuwane. Powiadomimy Cię o tym z co najmniej 12-miesięcznym wyprzedzeniem. Więcej informacji znajdziesz na stronie https://developers.google.com/maps/deprecations, a przewodnik po migracji – na https://developers.google.com/maps/documentation/javascript/advanced-markers/migration.

Ta klasa rozszerza klasę MVCObject.

Dostęp przez połączenie pod numer const {Marker} = await google.maps.importLibrary("marker").
 Zobacz Biblioteki w Maps JavaScript API.

Zespół
Marker	Marker([opts]) Parametry:  opts:  MarkerOptions optional nazwane argumenty opcjonalne Tworzy znacznik z określonymi opcjami. Jeśli mapa jest określona, znacznik jest dodawany do mapy podczas tworzenia. Pamiętaj, że aby znacznik się wyświetlał, musisz ustawić jego pozycję.

Stałe
MAX_ZINDEX	Maksymalna domyślna wartość wskaźnika z-index, jaką interfejs API przypisze do markera. Możesz ustawić wyższą wartość wskaźnika z-index, aby przenieść znacznik na wierzch.

Metody
getAnimation	getAnimation() Parametry: brak Zwracana wartość:  Animation|null|undefined Pobiera aktualnie odtwarzaną animację.
getClickable	getClickable() Parametry: brak Wartość zwracana:  boolean wartość Prawda, jeśli w marker można kliknąć. Sprawdź, czy element Marker można kliknąć.
getCursor	getCursor() Parametry: brak Zwracana wartość:  string|null|undefined Pobiera typ kursora myszy wyświetlany po najechaniu.
getDraggable	getDraggable() Parametry: brak Wartość zwracana:  boolean Prawda, jeśli znacznik można przeciągać. Pobierz stan elementu Marker, który można przeciągać.
getIcon	getIcon() Parametry: brak Zwracana wartość:  string|Icon|Symbol|null|undefined Pobierz ikonę Marker. Zobacz MarkerOptions.icon.
getLabel	getLabel() Parametry: brak Zwracana wartość:  MarkerLabel|string|null|undefined Pobierz etykietę Marker. Zobacz MarkerOptions.label.
getMap	getMap() Parametry: brak Zwracana wartość:  Map|StreetViewPanorama Pobierz mapę lub panoramę, na której renderowane jest urządzenie Marker.
getOpacity	getOpacity() Parametry: brak Zwracana wartość:  number|null|undefined liczba z zakresu od 0,0 do 1,0. Pobierz wartość przezroczystości elementu Marker.
getPosition	getPosition() Parametry: brak Zwracana wartość:  LatLng|null|undefined Pobierz pozycję Marker.
getShape	getShape() Parametry: brak Zwracana wartość:  MarkerShape|null|undefined Pobierz kształt Marker użyty do interakcji. Zobacz MarkerOptions.shape i MarkerShape.
getTitle	getTitle() Parametry: brak Zwracana wartość:  string|null|undefined Pobierz tytuł Marker etykietki. Zobacz MarkerOptions.title.
getVisible	getVisible() Parametry: brak Wartość zwracana:  boolean wartość „true”, jeśli znacznik jest widoczny. Uzyskaj widoczność Marker.
getZIndex	getZIndex() Parametry: brak Zwracana wartość:  number|null|undefined indeks Z znacznika. Pobierz zIndex elementu Marker. Zobacz MarkerOptions.zIndex.
setAnimation	setAnimation([animation]) Parametry:  animation:  Animation optional animacja do odtworzenia. Zwracana wartość: brak Uruchom animację. Wszelkie trwające animacje zostaną anulowane. Obecnie obsługiwane animacje to: Animation.BOUNCE, Animation.DROP. Przekazanie wartości null spowoduje zatrzymanie animacji.
setClickable	setClickable(flag) Parametry:  flag:  boolean Jeśli true, w znacznik można kliknąć. Zwracana wartość: brak Określ, czy element Marker można kliknąć.
setCursor	setCursor([cursor]) Parametry:  cursor:  string optional typ kursora myszy. Zwracana wartość: brak Ustaw typ kursora myszy wyświetlany po najechaniu.
setDraggable	setDraggable(flag) Parametry:  flag:  boolean optional Jeśli true, znacznik można przeciągnąć. Zwracana wartość: brak Określ, czy element Marker można przeciągać.
setIcon	setIcon([icon]) Parametry:  icon:  string|Icon|Symbol optional Zwracana wartość: brak Ustaw ikonę dla Marker. Zobacz MarkerOptions.icon.
setLabel	setLabel([label]) Parametry:  label:  string|MarkerLabel optional etykieta może być ciągiem znaków lub obiektem MarkerLabel. Zwracana wartość: brak Ustaw etykietę dla elementu Marker. Zobacz MarkerOptions.label.
setMap	setMap(map) Parametry:  map:  Map|StreetViewPanorama Zwracana wartość: brak Renderuje ikonę Marker na określonej mapie lub panoramie. Jeśli mapa jest ustawiona na null, znacznik zostanie usunięty.
setOpacity	setOpacity([opacity]) Parametry:  opacity:  number optional Liczba z zakresu od 0,0 (przezroczysta) do 1,0 (nieprzezroczysta). Zwracana wartość: brak Ustaw nieprzezroczystość elementu Marker.
setOptions	setOptions(options) Parametry:  options:  MarkerOptions Zwracana wartość: brak Ustaw opcje dla Marker.
setPosition	setPosition([latlng]) Parametry:  latlng:  LatLng|LatLngLiteral optional nowe stanowisko. Zwracana wartość: brak Ustaw pozycję dla elementu Marker.
setShape	setShape([shape]) Parametry:  shape:  MarkerShape optional Zwracana wartość: brak Ustaw kształt Marker używanego do interakcji. Zobacz MarkerOptions.shape i MarkerShape.
setTitle	setTitle([title]) Parametry:  title:  string optional Zwracana wartość: brak Ustaw tytuł etykietki Marker. Zobacz MarkerOptions.title.
setVisible	setVisible(visible) Parametry:  visible:  boolean Jeśli true, znacznik jest widoczny. Zwracana wartość: brak Ustaw, czy Marker ma być widoczny.
setZIndex	setZIndex([zIndex]) Parametry:  zIndex:  number optional Zwracana wartość: brak Ustaw zIndex elementu Marker. Zobacz MarkerOptions.zIndex.
Odziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Wydarzenia
animation_changed	function() Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość animacji Marker.
click	function(event) Argumenty:  event:  MapMouseEvent To zdarzenie jest wywoływane po kliknięciu ikony Marker.
clickable_changed	function() Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość MarkerclickableMarker.
contextmenu	function(event) Argumenty:  event:  MapMouseEvent To zdarzenie jest wywoływane, gdy zdarzenie DOM contextmenu jest wywoływane w elemencie Marker.
cursor_changed	function() Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość Markerkursora.
dblclick	function(event) Argumenty:  event:  MapMouseEvent To zdarzenie jest wywoływane po dwukrotnym kliknięciu ikony Marker.
drag	function(event) Argumenty:  event:  MapMouseEvent To zdarzenie jest wywoływane wielokrotnie, gdy użytkownik przeciąga element Marker.
dragend	function(event) Argumenty:  event:  MapMouseEvent To zdarzenie jest uruchamiane, gdy użytkownik przestanie przeciągać element Marker.
draggable_changed	function() Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość Marker draggable.
dragstart	function(event) Argumenty:  event:  MapMouseEvent To zdarzenie jest wywoływane, gdy użytkownik zaczyna przeciągać element Marker.
flat_changed	function() Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość płaska Marker.
icon_changed	function() Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość ikony Marker.
mousedown	function(event) Argumenty:  event:  MapMouseEvent To zdarzenie jest wywoływane po naciśnięciu przycisku myszy na elemencie Marker.
mouseout	function(event) Argumenty:  event:  MapMouseEvent To zdarzenie jest uruchamiane, gdy wskaźnik myszy opuści obszar ikony Marker.
mouseover	function(event) Argumenty:  event:  MapMouseEvent To zdarzenie jest wywoływane, gdy kursor myszy znajdzie się w obszarze ikony Marker.
mouseup	function(event) Argumenty:  event:  MapMouseEvent To zdarzenie jest wywoływane po zwolnieniu przycisku myszy na elemencie Marker.
position_changed	function() Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość Marker position.
shape_changed	function() Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość kształtu Marker.
title_changed	function() Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się Markerwłaściwość tytułu.
visible_changed	function() Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość Markervisible.
zindex_changed	function() Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość MarkerzIndex.
rightclick	Wycofane: zamiast tego użyj zdarzenia Marker.contextmenu, aby obsługiwać wzorce użycia, takie jak kliknięcie z naciśniętym klawiszem Control na macOS. function(event) Argumenty:  event:  MapMouseEvent To zdarzenie jest wywoływane po kliknięciu prawym przyciskiem myszy elementu Marker.

MarkerOptions interfejs

google.maps.MarkerOptionsinterfejs

Wycofane: 21 lutego 2024 r. wycofaliśmy znacznik google.maps.Marker. Zamiast niego używaj znaczników google.maps.marker.AdvancedMarkerElement. Szczegółowe informacje o wycofaniu znajdziesz na stronie https://developers.google.com/maps/deprecations, a przewodnik po migracji – na stronie https://developers.google.com/maps/documentation/javascript/advanced-markers/migration.

Obiekt MarkerOptions używany do określania właściwości, które można ustawić w przypadku znacznika.

Właściwości
anchorPoint optional	Typ:  Point optional Przesunięcie od pozycji znacznika do wierzchołka okna informacyjnego, które zostało otwarte ze znacznikiem jako punktem zakotwiczenia.
animation optional	Typ:  Animation optional Domyślnie: null Animacja, która ma być odtwarzana po dodaniu znacznika do mapy.
clickable optional	Typ:  boolean optional Domyślnie: true Jeśli true, znacznik odbiera zdarzenia myszy i dotyku.
collisionBehavior optional	Wycofane: collisionBehavior zostało wycofane w lipcu 2023 r. Zamiast niej używaj zasady AdvancedMarkerElement.collisionBehavior. Uwaga: dostępna tylko na kanale v=beta. Typ:  string|CollisionBehavior optional Domyślnie: null Ustawianie zachowania znaczników na mapach wektorowych w przypadku kolizji.
crossOnDrag optional	Typ:  boolean optional Domyślnie: true Jeśli false, wyłącza krzyżyk, który pojawia się pod markerem podczas przeciągania.
cursor optional	Typ:  string optional Domyślnie: pointer Typ kursora myszy, który ma się wyświetlać po najechaniu na element.
draggable optional	Typ:  boolean optional Domyślnie: false Jeśli true, znacznik można przeciągnąć. Uwaga: ustawienie wartości true spowoduje, że znacznik będzie klikalny nawet wtedy, gdy wartość clickable będzie ustawiona na false.
icon optional	Typ:  string|Icon|Symbol optional Ikona pierwszego planu. Jeśli podany jest ciąg znaków, jest on traktowany tak, jakby był obiektem Icon, w którym ciąg znaków jest wartością pola url.
label optional	Typ:  string|MarkerLabel optional Domyślnie: null Dodaje etykietę do znacznika. Etykieta znacznika to litera lub cyfra, która pojawia się wewnątrz znacznika. Etykieta może być ciągiem znaków lub obiektem MarkerLabel. Jeśli podano wartość parametru MarkerOptions.title, a nie podano wartości parametru MarkerOptions.title, do znacznika zostanie dodany tekst ułatwień dostępu (np. do użycia z czytnikami ekranu) z tekstem podanej etykiety. Pamiętaj, że symbol label jest obecnie używany tylko w tekście ułatwień dostępu w przypadku nieoptymalizowanych znaczników.
map optional	Typ:  Map|StreetViewPanorama optional Mapa, na której ma być wyświetlany znacznik. Mapa jest wymagana do wyświetlenia znacznika i może być podana za pomocą Marker.setMap, jeśli nie została podana podczas tworzenia znacznika.
opacity optional	Typ:  number optional Wartość domyślna: 1.0 Liczba z zakresu od 0,0 (przezroczystość) do 1,0 (nieprzezroczystość).
optimized optional	Typ:  boolean optional Optymalizacja zwiększa wydajność, renderując wiele znaczników jako jeden element statyczny. Jest to przydatne w przypadku, gdy wymagana jest duża liczba znaczników. Dowiedz się więcej o optymalizacji markerów. Uwaga: ta optymalizacja nie ma wpływu na znaczniki na mapach wektorowych.
position optional	Typ:  LatLng|LatLngLiteral optional Ustawia pozycję znacznika. Może zostać utworzony znacznik, ale nie będzie on wyświetlany, dopóki nie zostanie podana jego pozycja – na przykład w wyniku działań lub wyborów użytkownika. Pozycję znacznika można podać za pomocą parametru Marker.setPosition, jeśli nie została podana podczas tworzenia znacznika.
shape optional	Typ:  MarkerShape optional Definicja regionu mapy obrazu używana do przeciągania lub klikania.
title optional	Typ:  string optional Domyślnie: undefined Tekst po najechaniu kursorem. Jeśli zostanie podany, do znacznika zostanie dodany tekst ułatwień dostępu (np. do użycia z czytnikami ekranu) o podanej wartości. Pamiętaj, że symbol title jest obecnie używany tylko w tekście ułatwień dostępu w przypadku nieoptymalizowanych znaczników.
visible optional	Typ:  boolean optional Domyślnie: true Jeśli true, znacznik jest widoczny.
zIndex optional	Typ:  number optional Wszystkie znaczniki są wyświetlane na mapie w kolejności ich indeksu z, przy czym znaczniki o wyższych wartościach są wyświetlane przed znacznikami o niższych wartościach. Domyślnie markery są wyświetlane zgodnie z ich pionową pozycją na ekranie. Markery znajdujące się niżej pojawiają się przed markerami znajdującymi się wyżej.

Stałe CollisionBehavior

google.maps.CollisionBehavior stałe

Dostęp przez połączenie pod numer const {CollisionBehavior} = await google.maps.importLibrary("marker").
 Zobacz Biblioteki w Maps JavaScript API.

Stałe
OPTIONAL_AND_HIDES_LOWER_PRIORITY	Wyświetlaj znacznik tylko wtedy, gdy nie nakłada się na inne znaczniki. Jeśli 2 markery tego typu nakładają się na siebie, wyświetlany jest ten o wyższej wartości zIndex. Jeśli mają tę samą wartość zIndex, wyświetlana jest ta, która znajduje się niżej na ekranie.
REQUIRED	Zawsze wyświetlaj znacznik, niezależnie od kolizji. Jest to zachowanie domyślne.
REQUIRED_AND_HIDES_OPTIONAL	Zawsze wyświetlaj znacznik niezależnie od kolizji i ukrywaj wszystkie znaczniki lub etykiety OPTIONAL_AND_HIDES_LOWER_PRIORITY, które mogłyby się z nim pokrywać.

Interfejs ikony

google.maps.Iconinterfejs

Struktura reprezentująca obraz ikony markera.

Właściwości
url	Typ:  string Adres URL obrazu lub arkusza sprite.
anchor optional	Typ:  Point optional Pozycja, w której obraz ma być zakotwiczony w odniesieniu do lokalizacji znacznika na mapie. Domyślnie punkt zakotwiczenia znajduje się w środku dolnej części obrazu.
labelOrigin optional	Typ:  Point optional Punkt początkowy etykiety względem lewego górnego rogu obrazu ikony, jeśli etykieta jest dostarczana przez znacznik. Domyślnie punkt początkowy znajduje się w środku obrazu.
origin optional	Typ:  Point optional Położenie obrazu w spricie (jeśli występuje). Domyślnie punkt początkowy znajduje się w lewym górnym rogu obrazu (0, 0).
scaledSize optional	Typ:  Size optional Rozmiar całego obrazu po ewentualnym skalowaniu. Użyj tej właściwości, aby rozciągnąć lub zmniejszyć obraz lub sprite’a.
size optional	Typ:  Size optional Rozmiar wyświetlania sprite’a lub obrazu. Jeśli używasz sprite’ów, musisz określić ich rozmiar. Jeśli rozmiar nie zostanie podany, zostanie ustawiony po wczytaniu obrazu.

MarkerLabel interfejs

google.maps.MarkerLabelinterfejs

Te opcje określają wygląd etykiety markera. Etykieta znacznika to ciąg znaków (często pojedynczy znak), który będzie wyświetlany w znaczniku. Jeśli używasz go z niestandardowym znacznikiem, możesz zmienić jego położenie za pomocą właściwości labelOrigin w klasie Icon.

Właściwości
text	Typ:  string Tekst, który ma być wyświetlany na etykiecie.
className optional	Typ:  string optional Wartość domyślna: '' (pusty ciąg tekstowy) Właściwość className elementu etykiety (odpowiednik atrybutu class elementu). Możesz dodać wiele klas CSS rozdzielonych spacjami. Kolor, rozmiar, grubość i rodzinę czcionki można ustawić tylko za pomocą innych właściwości MarkerLabel. Klas CSS nie należy używać do zmiany pozycji ani orientacji etykiety (np. za pomocą translacji i obrotów), jeśli używasz też zarządzania kolizjami znaczników.
color optional	Typ:  string optional Domyślnie: 'black' Kolor tekstu etykiety.
fontFamily optional	Typ:  string optional Rodzina czcionek tekstu etykiety (odpowiednik właściwości CSS font-family).
fontSize optional	Typ:  string optional Domyślnie: '14px' Rozmiar czcionki tekstu etykiety (odpowiednik właściwości CSS font-size).
fontWeight optional	Typ:  string optional Grubość czcionki tekstu etykiety (odpowiednik właściwości CSS font-weight).

MarkerShape interfejs

google.maps.MarkerShapeinterfejs

Ten obiekt definiuje obszar klikalny obrazu znacznika. Kształt składa się z 2 właściwości – type i coord – które określają nieprzezroczysty obszar obrazu.

Właściwości
type	Typ:  string Określa typ kształtu i może mieć wartość circle, poly lub rect.
coords optional	Typ:  Array<number> optional Format tego atrybutu zależy od wartości type i jest zgodny ze specyfikacją w3 AREA coords, którą znajdziesz na stronie http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. Atrybut coords to tablica liczb całkowitych określających położenie kształtu w pikselach względem lewego górnego rogu obrazu docelowego. Współrzędne zależą od wartości type w ten sposób:   - circle: coords to [x1,y1,r], gdzie x1,y2 to współrzędne środka okręgu, a r to promień okręgu.   - poly: coords to [x1,y1,x2,y2...xn,yn], gdzie każda para x,y zawiera współrzędne jednego wierzchołka wielokąta.   - rect: coords to [x1,y1,x2,y2], gdzie x1,y1 to współrzędne lewego górnego rogu prostokąta, a x2,y2 to współrzędne prawego dolnego rogu prostokąta.

Symbol interfejs

google.maps.Symbolinterfejs

Opisuje symbol, który składa się ze ścieżki wektorowej ze stylem. Symbol może być używany jako ikona znacznika lub umieszczany na polilinii.

Właściwości
path	Typ:  SymbolPath|string Ścieżka symbolu, która jest wbudowaną ścieżką symbolu lub ścieżką niestandardową wyrażoną za pomocą notacji ścieżki SVG. Wymagane.
anchor optional	Typ:  Point optional Domyślnie: google.maps.Point(0,0) Położenie symbolu względem znacznika lub linii łamanej. Współrzędne ścieżki symbolu są przesuwane w lewo i w górę odpowiednio o współrzędne x i y punktu zakotwiczenia. Pozycja jest wyrażona w tym samym układzie współrzędnych co ścieżka symbolu.
fillColor optional	Typ:  string optional Kolor wypełnienia symbolu. Obsługiwane są wszystkie kolory CSS3 z wyjątkiem rozszerzonych nazw kolorów. W przypadku znaczników symboli domyślnie jest to „black”. W przypadku symboli na liniach łamanych jest to domyślnie kolor linii łamanej.
fillOpacity optional	Typ:  number optional Domyślnie: 0 Przezroczystość wypełnienia symbolu.
labelOrigin optional	Typ:  Point optional Domyślnie: google.maps.Point(0,0) Pochodzenie etykiety względem pochodzenia ścieżki, jeśli etykieta jest dostarczana przez znacznik. Początek jest wyrażony w tym samym układzie współrzędnych co ścieżka symbolu. Ta właściwość nie jest używana w przypadku symboli na poliliniach.
rotation optional	Typ:  number optional Domyślnie: 0 Kąt, o który należy obrócić symbol, wyrażony w stopniach zgodnie z ruchem wskazówek zegara. Symbol w IconSequence, gdzie fixedRotation to false, jest obrócony względem kąta krawędzi, na której się znajduje.
scale optional	Typ:  number optional Wartość, o którą symbol jest skalowany. W przypadku znaczników symboli domyślna wartość to 1. Po skalowaniu symbol może mieć dowolny rozmiar. W przypadku symboli na polilinii domyślnie jest to grubość linii polilinii. Po przeskalowaniu symbol musi znajdować się w kwadracie o rozmiarze 22 pikseli wyśrodkowanym na punkcie zakotwiczenia symbolu.
strokeColor optional	Typ:  string optional Kolor obrysu symbolu. Obsługiwane są wszystkie kolory CSS3 z wyjątkiem rozszerzonych nazw kolorów. W przypadku znaczników symboli domyślnie jest to „black”. W przypadku symboli na linii łamanej jest to domyślnie kolor linii łamanej.
strokeOpacity optional	Typ:  number optional Przezroczystość konturu symbolu. W przypadku znaczników symboli domyślna wartość to 1. W przypadku symboli na linii łamanej domyślnie jest to krycie linii łamanej.
strokeWeight optional	Typ:  number optional Domyślna: Symbol.scale symbolu. Grubość konturu symbolu.

SymbolPath constants

google.maps.SymbolPath stałe

Wbudowane ścieżki symboli.

Dostęp przez połączenie pod numer const {SymbolPath} = await google.maps.importLibrary("core").
 Zobacz Biblioteki w Maps JavaScript API.

Stałe
BACKWARD_CLOSED_ARROW	Zamknięta strzałka skierowana w lewo.
BACKWARD_OPEN_ARROW	Otwarta strzałka skierowana w lewo.
CIRCLE	okrąg,
FORWARD_CLOSED_ARROW	Zamknięta strzałka skierowana do przodu.
FORWARD_OPEN_ARROW	Otwarta strzałka skierowana do przodu.

Stałe animacji

google.maps.Animation stałe

Animacje, które można odtworzyć na znaczniku. Użyj metody Marker.setAnimation na znaczniku lub opcji MarkerOptions.animation, aby odtworzyć animację.

Dostęp przez połączenie pod numer const {Animation} = await google.maps.importLibrary("marker").
 Zobacz Biblioteki w Maps JavaScript API.

Stałe
BOUNCE	Znacznik podskakuje, dopóki animacja nie zostanie zatrzymana przez wywołanie funkcji Marker.setAnimation z parametrem null.
DROP	Znacznik spada z góry mapy do miejsca docelowego. Animacja zakończy się, gdy znacznik się zatrzyma, a Marker.getAnimation wróci do pozycji null. Ten typ animacji jest zwykle określany podczas tworzenia markera.