Marker (legacy)

Klasa Marker

google.maps.Marker class
extends MVCObject
library "marker"

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 AdvancedMarkerElement zamiast google.maps.Marker. Będziemy nadal naprawiać błędy w znaczniku google.maps.Marker w przypadku poważnych regresji, ale nie będziemy rozwiązywać istniejących problemów z tym znacznikiem. O zakończeniu wsparcia poinformujemy z co najmniej 12-miesięcznym wyprzedzeniem. Więcej informacji 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.

const {Marker} = await google.maps.importLibrary("marker");

Zespół
Marker	Marker([opts]) Parametry: opts: MarkerOptions optional 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ć pozycję.

Stałe
MAX_ZINDEX	Maksymalny domyślny indeks Z, który interfejs API przypisze do znacznika. Możesz ustawić wyższy indeks Z, aby przesunąć znacznik na pierwszy plan.

Metody
getAnimation	getAnimation() Parametry: brak Wartość zwracana: Animation|null|undefined Pobierz aktualnie uruchomioną animację.
getClickable	getClickable() Parametry: brak Wartość zwracana: boolean True, jeśli znacznik jest klikalny. Pobierz stan klikalności elementu Marker.
getCursor	getCursor() Parametry: brak Wartość zwracana: string|null|undefined Pobierz typ kursora myszy wyświetlany po najechaniu kursorem.
getDraggable	getDraggable() Parametry: brak Wartość zwracana: boolean True, jeśli znacznik można przeciągać. Sprawdź, czy element Marker można przeciągać.
getIcon	getIcon() Parametry: brak Wartość zwracana: string|Icon|Symbol|null|undefined Pobierz ikonę Marker. Zobacz MarkerOptions.icon.
getLabel	getLabel() Parametry: brak Wartość zwracana: MarkerLabel|string|null|undefined Pobierz etykietę Marker. Zobacz MarkerOptions.label.
getMap	getMap() Parametry: brak Wartość zwracana: Map|StreetViewPanorama|null Pobierz mapę lub panoramę, na której jest renderowany element Marker.
getOpacity	getOpacity() Parametry: brak Zwracana wartość: number|null|undefined liczba z zakresu od 0,0 do 1,0. Pobierz przezroczystość elementu (Marker).
getPosition	getPosition() Parametry: brak Wartość zwracana: LatLng|null|undefined Sprawdź pozycję elementu Marker.
getShape	getShape() Parametry: brak Wartość zwracana: MarkerShape|null|undefined Pobierz kształt Marker używanego do interakcji. Zobacz MarkerOptions.shape oraz MarkerShape.
getTitle	getTitle() Parametry: brak Wartość zwracana: string|null|undefined Pobierz tytuł etykietki Marker. Zobacz MarkerOptions.title.
getVisible	getVisible() Parametry: brak Wartość zwracana: boolean True, jeśli znacznik jest widoczny. Uzyskaj widoczność Marker.
getZIndex	getZIndex() Parametry: brak Zwracana wartość: number|null|undefined zIndex znacznika. Pobierz zIndex elementu Marker. Zobacz MarkerOptions.zIndex.
setAnimation	setAnimation([animation]) Parametry: animation: Animation optional Animacja do odtworzenia. Zwracana wartość: brak Uruchom animację. Wszystkie 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, 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świetlanego po najechaniu.
setDraggable	setDraggable(flag) Parametry: flag: boolean optional Jeśli true, znacznik można przeciągać. 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: Marker. Zobacz MarkerOptions.label.
setMap	setMap(map) Parametry: map: Map|StreetViewPanorama optional Zwracana wartość: brak Renderuje 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 (przezroczysty) do 1,0 (nieprzezroczysty). Zwracana wartość: brak Ustaw nieprzezroczystość elementu Marker.
setOptions	setOptions(options) Parametry: options: MarkerOptions optional Zwracana wartość: brak Ustaw opcje dla Marker.
setPosition	setPosition([latlng]) Parametry: latlng: LatLng|LatLngLiteral optional Nowa pozycja. Zwracana wartość: brak Ustaw pozycję dla Marker.
setShape	setShape([shape]) Parametry: shape: MarkerShape optional Zwracana wartość: brak Ustaw kształt elementu Marker używanego do interakcji. Zobacz MarkerOptions.shape oraz 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 Określ, czy Marker jest widoczny.
setZIndex	setZIndex([zIndex]) Parametry: zIndex: number optional Zwracana wartość: brak Ustaw zIndex elementu Marker. Zobacz MarkerOptions.zIndex.
Dziedziczone: 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 optional 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ść Marker clickable.
contextmenu	function(event) Argumenty: event: MapMouseEvent optional To zdarzenie jest wywoływane, gdy zdarzenie contextmenu DOM jest wywoływane w obiekcie Marker
cursor_changed	function() Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość kursora Marker.
dblclick	function(event) Argumenty: event: MapMouseEvent optional To zdarzenie jest wywoływane po dwukrotnym kliknięciu ikony Marker.
drag	function(event) Argumenty: event: MapMouseEvent optional To zdarzenie jest wywoływane wielokrotnie, gdy użytkownik przeciąga element Marker.
dragend	function(event) Argumenty: event: MapMouseEvent optional To zdarzenie jest wywoływane, gdy użytkownik przestaje 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 optional 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ść 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 optional To zdarzenie jest wywoływane po kliknięciu elementu Marker.
mouseout	function(event) Argumenty: event: MapMouseEvent optional To zdarzenie jest wywoływane, gdy kursor myszy opuszcza obszar ikony Marker.
mouseover	function(event) Argumenty: event: MapMouseEvent optional To zdarzenie jest wywoływane, gdy kursor myszy znajdzie się w obszarze ikony Marker.
mouseup	function(event) Argumenty: event: MapMouseEvent optional 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ść pozycji Marker.
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ę właściwość tytułu Marker.
visible_changed	function() Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość widoczności Marker.
zindex_changed	function() Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość zIndex obiektu Marker.
rightclick	Wycofane: zamiast tego użyj zdarzenia Marker.contextmenu, aby obsługiwać wzorce użytkowania, takie jak kliknięcie z klawiszem Control w systemie macOS. function(event) Argumenty: event: MapMouseEvent optional To zdarzenie jest wywoływane po kliknięciu prawym przyciskiem myszy elementu Marker.

MarkerOptions interfejs

Interfejs google.maps.MarkerOptions

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 służący do definiowania właściwości, które można ustawić w znaczniku.

Właściwości
anchorPoint opcjonalne	Typ: Point optional Przesunięcie od pozycji znacznika do końcówki okna informacyjnego, które zostało otwarte ze znacznikiem jako kotwicą.
animation opcjonalne	Typ: Animation optional Domyślnie: null Animacja, która ma być odtwarzana po dodaniu znacznika do mapy.
clickable opcjonalne	Typ: boolean optional Domyślnie: true Jeśli true, znacznik odbiera zdarzenia myszy i dotknięcia.
collisionBehavior opcjonalne	Wycofane: środowisko collisionBehavior zostało wycofane w lipcu 2023 r. Użyj w zamian zasady AdvancedMarkerElement.collisionBehavior. Uwaga: ta funkcja jest dostępna tylko w wersji beta. Typ: string|CollisionBehavior optional Domyślnie: null Ustaw zachowanie przy kolizji znaczników na mapach wektorowych.
crossOnDrag opcjonalne	Typ: boolean optional Domyślnie: true Jeśli ma wartość false, wyłącza krzyżyk, który pojawia się pod znacznikiem podczas przeciągania.
cursor opcjonalne	Typ: string optional Domyślnie: pointer Typ kursora myszy, który ma być wyświetlany po najechaniu.
draggable opcjonalne	Typ: boolean optional Domyślnie: false Jeśli wartość to true, znacznik można przeciągać. Uwaga: jeśli ustawisz tę wartość na true, znacznik będzie klikalny, nawet jeśli właściwość clickable będzie ustawiona na false.
icon opcjonalne	Typ: string|Icon|Symbol optional Ikona pierwszego planu. Jeśli podany jest ciąg znaków, jest on traktowany tak, jakby był Icon z ciągiem znaków jako url.
label opcjonalne	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 tę wartość, a nie podano wartości MarkerOptions.title, do znacznika zostanie dodany tekst ułatwień dostępu (np. do użytku z czytnikami ekranu) z tekstem podanej etykiety. Pamiętaj, że label jest obecnie używany tylko w tekście ułatwień dostępu w przypadku niezoptymalizowanych znaczników.
map opcjonalne	Typ: Map|StreetViewPanorama optional Mapa, na której ma być wyświetlany znacznik. Mapa jest wymagana do wyświetlenia znacznika i można ją podać za pomocą Marker.setMap, jeśli nie została podana podczas tworzenia znacznika.
opacity opcjonalne	Typ: number optional Wartość domyślna: 1.0 Liczba z zakresu od 0,0 (przezroczysty) do 1,0 (nieprzezroczysty).
optimized opcjonalne	Typ: boolean optional Optymalizacja zwiększa wydajność, renderując wiele znaczników jako jeden element statyczny. Jest to przydatne, gdy wymagana jest duża liczba znaczników. Dowiedz się więcej o optymalizacji znaczników. Uwaga: ta optymalizacja nie ma wpływu na znaczniki na mapach wektorowych.
position opcjonalne	Typ: LatLng|LatLngLiteral optional Ustawia pozycję znacznika. Znacznik może zostać utworzony, ale nie będzie 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ą metody Marker.setPosition, jeśli nie została podana podczas tworzenia znacznika.
shape opcjonalne	Typ: MarkerShape optional Definicja regionu mapy obrazu używana do przeciągania/kliknięcia.
title opcjonalne	Typ: string optional Domyślnie: undefined Tekst po najechaniu kursorem. Jeśli podasz tekst ułatwień dostępu (np. do użycia z czytnikami ekranu), zostanie on dodany do znacznika z podaną wartością. Pamiętaj, że title jest obecnie używany tylko w tekście ułatwień dostępu w przypadku niezoptymalizowanych znaczników.
visible opcjonalne	Typ: boolean optional Domyślnie: true Jeśli true, znacznik jest widoczny.
zIndex opcjonalne	Typ: number optional Wszystkie znaczniki są wyświetlane na mapie w kolejności ich wartości zIndex, przy czym znaczniki o wyższych wartościach są wyświetlane przed znacznikami o niższych wartościach. Domyślnie znaczniki są wyświetlane zgodnie z ich pozycją w pionie na ekranie, przy czym znaczniki znajdujące się niżej pojawiają się przed znacznikami znajdującymi się wyżej.

Stałe CollisionBehavior

google.maps.CollisionBehavior stałe
biblioteka "marker"

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ CollisionBehaviorString.

const {CollisionBehavior} = await google.maps.importLibrary("marker");

Stałe
OPTIONAL_AND_HIDES_LOWER_PRIORITY	Wyświetlaj znacznik tylko wtedy, gdy nie nakłada się na inne znaczniki. Jeśli 2 znaczniki tego typu nakładają się na siebie, wyświetlany jest ten z wyższą wartością zIndex. Jeśli mają ten sam zIndex, wyświetlany jest ten znacznik, który znajduje się niżej na ekranie.
REQUIRED	Zawsze wyświetlaj znacznik niezależnie od kolizji. Jest to działanie 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 Icon

Interfejs google.maps.Icon

Struktura reprezentująca obraz ikony znacznika.

Właściwości
url	Typ: string Adres URL obrazu lub arkusza sprite.
anchor opcjonalne	Typ: Point optional Pozycja, w której obraz ma być zakotwiczony w odniesieniu do lokalizacji znacznika na mapie. Domyślnie punkt zakotwiczenia znajduje się na środku dolnej krawędzi obrazu.
labelOrigin opcjonalne	Typ: Point optional Początek 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 opcjonalne	Typ: Point optional Pozycja obrazu w duszku (jeśli występuje). Domyślnie punkt początkowy znajduje się w lewym górnym rogu obrazu (0, 0).
scaledSize opcjonalne	Typ: Size optional Rozmiar całego obrazu po ewentualnym przeskalowaniu. Użyj tej właściwości, aby rozciągnąć lub zmniejszyć obraz albo duszka.
size opcjonalne	Typ: Size optional Rozmiar wyświetlania duszka lub obrazu. Jeśli używasz duszków, musisz określić ich rozmiar. Jeśli rozmiar nie zostanie podany, zostanie ustawiony podczas wczytywania obrazu.

Interfejs MarkerLabel

Interfejs google.maps.MarkerLabel

Te opcje określają wygląd etykiety znacznika. Etykieta znacznika to ciąg znaków (często pojedynczy znak), który pojawi się wewnątrz znacznika. Jeśli używasz go z niestandardowym znacznikiem, możesz zmienić jego pozycję 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 opcjonalne	Typ: string optional Wartość domyślna: '' (pusty ciąg znaków) 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 elementu 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 opcjonalne	Typ: string optional Domyślnie: 'black' Kolor tekstu etykiety.
fontFamily opcjonalne	Typ: string optional Rodzina czcionek tekstu etykiety (odpowiednik właściwości font-family w CSS).
fontSize opcjonalne	Typ: string optional Domyślnie: '14px' Rozmiar czcionki tekstu etykiety (odpowiednik właściwości font-size w CSS).
fontWeight opcjonalne	Typ: string optional Grubość czcionki tekstu etykiety (odpowiednik właściwości font-weight w CSS).

Interfejs MarkerShape

Interfejs google.maps.MarkerShape

Ten obiekt definiuje obszar obrazu znacznika, który można kliknąć. Kształt składa się z 2 właściwości – type i coord – które definiują nieprzezroczysty obszar obrazu.

Właściwości
type	Typ: string Opisuje typ kształtu i może mieć wartość circle, poly lub rect.
coords opcjonalne	Typ: Array<number> optional Format tego atrybutu zależy od wartości type i jest zgodny ze specyfikacją w3 AREA coords, którą można znaleźć na stronie http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. Atrybut coords to tablica liczb całkowitych, które określają pozycję pikseli kształtu względem lewego górnego rogu obrazu docelowego. Współrzędne zależą od wartości type w następujący sposób:   – circle: współrzędne 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.

Interfejs Symbol

Interfejs google.maps.Symbol

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

Właściwości
path	Typ: SymbolPath|string Ścieżka symbolu, która jest wbudowaną ścieżką symbolu, lub ścieżka niestandardowa wyrażona za pomocą notacji ścieżki SVG. Wymagane.
anchor opcjonalne	Typ: Point optional Domyślnie: google.maps.Point(0,0) Pozycja 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 opcjonalne	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ślna wartość to „black” (czarny). W przypadku symboli na liniach łamanych domyślnie jest to kolor obrysu odpowiedniej linii łamanej.
fillOpacity opcjonalne	Typ: number optional Domyślnie: 0 Nieprzezroczystość wypełnienia symbolu.
labelOrigin opcjonalne	Typ: Point optional Domyślnie: google.maps.Point(0,0) Punkt początkowy etykiety względem punktu początkowego ścieżki, jeśli etykieta jest dostarczana przez znacznik. Punkt początkowy 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 liniach łamanych.
rotation opcjonalne	Typ: number optional Domyślnie: 0 Kąt, o który ma zostać obrócony symbol, wyrażony w stopniach zgodnie z ruchem wskazówek zegara. Symbol w elemencie IconSequence, gdzie fixedRotation to false, jest obrócony względem kąta krawędzi, na której się znajduje.
scale opcjonalne	Typ: number optional Wartość, o którą jest skalowany rozmiar symbolu. W przypadku znaczników symboli domyślna wartość to 1. Po przeskalowaniu symbol może mieć dowolny rozmiar. W przypadku symboli na linii łamanej domyślnie jest to grubość linii łamanej. Po przeskalowaniu symbol musi mieścić się w kwadracie o rozmiarze 22 pikseli wyśrodkowanym na punkcie zakotwiczenia symbolu.
strokeColor opcjonalne	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ślna wartość to „black” (czarny). W przypadku symboli na linii łamanej domyślnie jest to kolor obrysu linii łamanej.
strokeOpacity opcjonalne	Typ: number optional Nieprzezroczystość linii symbolu. W przypadku znaczników symboli domyślna wartość to 1. W przypadku symboli na linii łamanej domyślnie jest to przezroczystość obrysu linii łamanej.
strokeWeight opcjonalne	Typ: number optional Domyślny: Symbol.scale symbolu. Grubość konturu symbolu.

Stałe SymbolPath

google.maps.SymbolPath stałe
biblioteka "core"

Wbudowane ścieżki symboli.

const {SymbolPath} = await google.maps.importLibrary("core");

Stałe
BACKWARD_CLOSED_ARROW	Zamknięta strzałka skierowana do tyłu.
BACKWARD_OPEN_ARROW	Otwarta strzałka skierowana do tyłu.
CIRCLE	Okrąg.
FORWARD_CLOSED_ARROW	Strzałka skierowana do przodu.
FORWARD_OPEN_ARROW	Otwarta strzałka skierowana do przodu.

Stałe animacji

google.maps.Animation stałe
biblioteka "marker"

Animacje, które można odtworzyć na znaczniku. Aby odtworzyć animację, użyj metody Marker.setAnimation w obiekcie Marker lub opcji MarkerOptions.animation.

const {Animation} = await google.maps.importLibrary("marker");

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 ostatecznej lokalizacji. Animacja zostanie zatrzymana, gdy znacznik się zatrzyma, a funkcja Marker.getAnimation zwróci wartość null. Ten typ animacji jest zwykle określany podczas tworzenia znacznika.