Klasa Marker
Klasa google.maps.Marker
Te zajęcia obejmują MVCObject
.
Zadzwoń pod numer const {Marker} = await google.maps.importLibrary("marker")
, aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
Marker |
Marker([opts]) Parametry:
Tworzy znacznik z określonymi opcjami. Jeśli określisz mapę, po utworzeniu znacznik zostanie do niej dodany znacznik. Pamiętaj, że położenie musi być ustawione, aby znacznik się wyświetlał. |
Metody | |
---|---|
getAnimation |
getAnimation() Parametry: brak
Wartość zwrotu:
Animation|null|undefined Pobierz obecnie animowaną animację. |
getClickable |
getClickable() Parametry: brak
Zwracana wartość:
boolean może mieć wartość Prawda, jeśli znacznik można kliknąć.Uzyskaj klikalny stan elementu Marker . |
getCursor |
getCursor() Parametry: brak
Wartość zwrotu:
string|null|undefined Najedź kursorem na typ kursora myszy. |
getDraggable |
getDraggable() Parametry: brak
Zwracana wartość:
boolean ma wartość Prawda, jeśli znacznik można przeciągać.Pobierz stan elementu Marker z możliwością przeciągania. |
getIcon |
getIcon() Parametry: brak
Pobierz ikonę: Marker . Zobacz MarkerOptions.icon . |
getLabel |
getLabel() Parametry: brak
Wartość zwrotu:
MarkerLabel|null|string|undefined Pobierz etykietę Marker . Zobacz MarkerOptions.label . |
getMap |
getMap() Parametry: brak
Wartość zwrotu:
Map|StreetViewPanorama Pobierz mapę lub panoramę, na której renderuje się Marker . |
getOpacity |
getOpacity() Parametry: brak
Zwracana wartość:
number|null|undefined liczba z zakresu od 0,0 do 1,0.Przezroczystość elementu Marker . |
getPosition |
getPosition() Parametry: brak
Wartość zwrotu:
LatLng|null|undefined Określ pozycję elementu Marker . |
getShape |
getShape() Parametry: brak
Wartość zwrotu:
MarkerShape|null|undefined Uzyskaj kształt elementu Marker używanego do interakcji. Zobacz MarkerOptions.shape oraz MarkerShape . |
getTitle |
getTitle() Parametry: brak
Wartość zwrotu:
string|null|undefined Pobierz tytuł etykietki Marker . Zobacz MarkerOptions.title . |
getVisible |
getVisible() Parametry: brak
Zwracana wartość:
boolean ma wartość Prawda, jeśli znacznik jest widoczny.Widoczność panelu Marker . |
getZIndex |
getZIndex() Parametry: brak
Wartość zwrócona:
number|null|undefined zindex znacznika.Pobieranie parametru zKolejność wartości parametru Marker . Zobacz MarkerOptions.zIndex . |
setAnimation |
setAnimation([animation]) Parametry:
Zwracana wartość: brak
Rozpocznij animację. Wszelkie trwające animacje zostaną anulowane. Obecnie obsługiwane animacje to: Animation.BOUNCE , Animation.DROP . Przekazywanie elementu null spowoduje zatrzymanie animacji. |
setClickable |
setClickable(flag) Parametry:
Zwracana wartość: brak
Określ, czy element Marker można kliknąć. |
setCursor |
setCursor([cursor]) Parametry:
Zwracana wartość: brak
Ustaw typ kursora myszy, który jest pokazywany po najechaniu kursorem. |
setDraggable |
setDraggable(flag) Parametry:
Zwracana wartość: brak
Określ, czy element Marker można przeciągać. |
setIcon |
setIcon([icon]) Zwracana wartość: brak
Ustaw ikonę Marker . Zobacz MarkerOptions.icon . |
setLabel |
setLabel([label]) Parametry:
Zwracana wartość: brak
Ustaw etykietę dla: Marker . Zobacz MarkerOptions.label . |
setMap |
setMap(map) Parametry:
Zwracana wartość: brak
Renderuje Marker na określonej mapie lub panoramy. Jeśli mapa ma wartość null , znacznik zostanie usunięty. |
setOpacity |
setOpacity([opacity]) Parametry:
Zwracana wartość: brak
Ustaw przezroczystość elementu Marker . |
setOptions |
setOptions(options) Parametry:
Zwracana wartość: brak
Ustaw opcje Marker . |
setPosition |
setPosition([latlng]) Parametry:
Zwracana wartość: brak
Ustaw instrukcję Marker . |
setShape |
setShape([shape]) Parametry:
Zwracana wartość: brak
|
setTitle |
setTitle([title]) Parametry:
Zwracana wartość: brak
Ustaw tytuł etykietki Marker . Zobacz MarkerOptions.title . |
setVisible |
setVisible(visible) Parametry:
Zwracana wartość: brak
Określ, czy Marker jest widoczny. |
setZIndex |
setZIndex([zIndex]) Parametry:
Zwracana wartość: brak
Ustaw kolejność nakładania elementów dla elementu Marker . Zobacz MarkerOptions.zIndex . |
Dziedziczone:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Stałe | |
---|---|
MAX_ZINDEX |
Maksymalna domyślna wartość z-index, jaką interfejs API przypisze do znacznika. Możesz ustawić wyższą wartość kolejności nakładania elementów, aby znacznik znalazł się na początku. |
Zdarzenia | |
---|---|
animation_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości animacji Marker . |
click |
function(event) Argumenty:
To zdarzenie jest wywoływane po kliknięciu ikony Marker . |
clickable_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości Marker , którą można kliknąć. |
contextmenu |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy zdarzenie menu kontekstowego DOM jest wywoływane w Marker |
cursor_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości kursora Marker . |
dblclick |
function(event) Argumenty:
To zdarzenie jest wywoływane po dwukrotnym kliknięciu ikony Marker . |
drag |
function(event) Argumenty:
To zdarzenie jest wywoływane wielokrotnie, gdy użytkownik przeciągnij element Marker . |
dragend |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy użytkownik przestaje przeciągać element Marker . |
draggable_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości przeciąganej przez Marker . |
dragstart |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy użytkownik zacznie przeciągać element Marker . |
flat_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości stałej Marker . |
icon_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości ikony Marker . |
mousedown |
function(event) Argumenty:
To zdarzenie jest wywoływane przez przesunięcie w dół na urządzeniu Marker . |
mouseout |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy kursor opuści obszar ikony Marker . |
mouseover |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy kursor myszy znajduje się w obszarze ikony Marker . |
mouseup |
function(event) Argumenty:
To zdarzenie jest uruchamiane w przypadku uruchomienia wskaźnika Marker na urządzeniu. |
position_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości pozycji Marker . |
shape_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości kształtu Marker . |
title_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości tytułu Marker . |
visible_changed |
function() Argumenty: brak
To zdarzenie jest uruchamiane po zmianie Marker widocznej właściwości. |
zindex_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości Marker indeksu. |
|
function(event) Argumenty:
To zdarzenie jest wywoływane przez kliknięcie prawym przyciskiem myszy zdarzenia Marker . |
Interfejs MarkerOptions
google.maps.MarkerOptions
interfejs
Obiekt MarkerOptions używany do definiowania właściwości, które można ustawić w znacznikach.
Właściwości | |
---|---|
anchorPoint optional |
Typ:
Point optional Przesunięcie od pozycji znacznika do końcówki okna informacyjnego, które zostały otwarte ze znacznikiem jako kotwica. |
animation optional |
Typ:
Animation optional Domyślne:
null Jaka animacja ma być odtwarzana po dodaniu znacznika do mapy. |
clickable optional |
Typ:
boolean optional Domyślne:
true Jeśli true , znacznik otrzymuje zdarzenia myszy i dotyku. |
|
Typ:
string|CollisionBehavior optional Domyślne:
null Ustaw zachowanie kolizji w przypadku znaczników na mapach wektorowych. |
crossOnDrag optional |
Typ:
boolean optional Domyślne:
true Jeśli zasada false wyłącza rysowanie krzyżyka wyświetlanego pod znacznikiem, przeciągaj je. |
cursor optional |
Typ:
string optional Domyślne:
pointer Typ kursora myszy, który ma być wyświetlany po najechaniu na nie kursorem myszy. |
draggable optional |
Typ:
boolean optional Domyślne:
false Jeśli true , znacznik można przeciągnąć. |
icon optional |
Ikona na pierwszym planie. Jeśli podasz ciąg znaków, będzie on traktowany jak ciąg Icon z ciągiem znaków url . |
label optional |
Typ:
string|MarkerLabel optional Domyślne:
null Dodaje etykietę do znacznika. Etykieta znacznika to litera lub cyfra wyświetlana w znaczniku. Etykieta może być ciągiem znaków lub obiektem MarkerLabel . Jeśli wartość MarkerOptions.title nie zostanie podana, do znacznika zostanie dodany tekst ułatwień dostępu (np. na potrzeby czytników ekranu). Pamiętaj, że element label jest obecnie używany tylko w przypadku tekstu ułatwień dostępu dla znaczników niezoptymalizowanych. |
map optional |
Typ:
Map|StreetViewPanorama optional Mapa, na której ma zostać wyświetlony znacznik Mapa jest niezbędna do wyświetlania znacznika. Jeśli nie podano tej wartości przy budowie znacznika, może być ona podana jako Marker.setMap . |
opacity optional |
Typ:
number optional Wartość domyślna: 1,0
Liczba z zakresu od 0, 0 do 1, 0, nieprzezroczysta. |
optimized optional |
Typ:
boolean optional Optymalizacja zwiększa skuteczność poprzez renderowanie wielu znaczników jako pojedynczych elementów statycznych. Jest to przydatne w przypadkach, gdy wymagana jest duża liczba znaczników. Więcej informacji o optymalizacji znaczników. |
position optional |
Typ:
LatLng|LatLngLiteral optional Ustawia położenie znacznika. Znacznik może być złożony, ale nie będzie wyświetlany, dopóki nie zostanie podany jego położenie – na przykład na podstawie działań lub wyborów użytkownika. Położenie znacznika możesz podać w polu Marker.setPosition , jeśli nie został podany na etapie tworzenia znacznika. |
shape optional |
Typ:
MarkerShape optional Definicja regionu mapy obrazu używana do przeciągania i klikania. |
title optional |
Typ:
string optional Domyślne:
undefined Tekst po najechaniu kursorem. Jeśli podasz tekst ułatwień dostępu (np. dla czytników ekranu), zostanie on dodany do podanej wartości. Pamiętaj, że element title jest obecnie używany tylko w przypadku tekstu ułatwień dostępu dla znaczników niezoptymalizowanych. |
visible optional |
Typ:
boolean optional Domyślne:
true Jeśli true , znacznik jest widoczny. |
zIndex optional |
Typ:
number optional Wszystkie znaczniki są wyświetlane na mapie w kolejności ich kolejności nakładania się elementów, przy czym wyższe wartości pojawiają się przed znacznikami o niższych wartościach. Domyślnie znaczniki pojawiają się na ekranie w pozycji pionowej, a niższe są wyświetlane przed nimi. |
Stałe kolizji
google.maps.CollisionBehavior
stałe
Zadzwoń pod numer const {CollisionBehavior} = await google.maps.importLibrary("marker")
, aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
OPTIONAL_AND_HIDES_LOWER_PRIORITY |
Wyświetlaj znacznik tylko wtedy, gdy nie pokrywa się on z innymi znacznikami. Jeśli dwa znaczniki tego typu nakładają się na siebie, wyświetlany jest ten o wyższym indeksie kolejności nakładania elementów. Jeśli mają taki sam zindex, wyświetli się ten o niższej pozycji ekranu w pionie. |
REQUIRED |
Zawsze wyświetlaj znacznik niezależnie od kolizji. Jest to jego ustawienie domyślne. |
REQUIRED_AND_HIDES_OPTIONAL |
Zawsze wyświetlaj znacznik niezależnie od kolizji i ukrywaj wszystkie OPTIONAL_AND_HIDES_LOWER_PRIORITY oraz etykiety, które będą się z nim pokrywać. |
Interfejs ikony
google.maps.Icon
interfejs
Struktura przedstawiająca ikonę znacznika.
Właściwości | |
---|---|
url |
Typ:
string Adres URL obrazu lub arkusza sprite. |
anchor optional |
Typ:
Point optional Pozycja, na której można zakotwiczyć zdjęcie w miejscu odpowiadającym lokalizacji znacznika na mapie. Domyślnie kotwica znajduje się wzdłuż punktu środkowego obrazu. |
labelOrigin optional |
Typ:
Point optional Źródło etykiety w lewym górnym rogu ikony, jeśli etykieta została podana przez znacznik. Punkt początkowy jest domyślnie umieszczony w centralnym punkcie obrazu. |
origin optional |
Typ:
Point optional Pozycja obrazu w serii sprite. Domyślnie źródło znajduje się w lewym górnym rogu obrazu (0, 0) . |
scaledSize optional |
Typ:
Size optional Rozmiar całego obrazu po przeskalowaniu, jeśli taki istnieje. Używaj tej właściwości, aby rozciągać lub zmniejszać obraz lub sprite. |
size optional |
Typ:
Size optional Rozmiar wyświetlania sprite lub obrazu. Jeśli korzystasz ze sprite’ów, musisz określić ich rozmiar. Jeśli nie podasz rozmiaru, zostanie on ustawiony podczas wczytywania obrazu. |
Interfejs MarkerLabel
google.maps.MarkerLabel
interfejs
Te opcje określają wygląd etykiety znacznika. Etykieta znacznika to ciąg znaków (często jeden pojedynczy znak), który będzie wyświetlany wewnątrz znacznika. Jeśli używasz jej ze znacznikiem niestandardowym, możesz ją przenieść za pomocą właściwości labelOrigin
w klasie Icon
.
Właściwości | |
---|---|
text |
Typ:
string Tekst, który ma się wyświetlić na etykiecie. |
className optional |
Typ:
string optional Domyślny:
'' (pusty ciąg znaków)Właściwość className elementu etykiety (odpowiednik atrybutu class elementu). Można dodać wiele klas CSS rozdzielanych spacjami. Kolor, rozmiar, wagę i rodzinę czcionek możesz ustawiać tylko za pomocą innych właściwości właściwości MarkerLabel . Klasy CSS nie powinny być używane do zmiany pozycji ani orientacji etykiety (np. przy użyciu tłumaczeń i rotacji), jeśli można też używać zarządzania kolizjami znaczników. |
color optional |
Typ:
string optional Domyślne:
'black' Kolor tekstu etykiety. |
fontFamily optional |
Typ:
string optional Rodzina czcionek tekstu etykiety (odpowiednik właściwości rodziny czcionek CSS). |
fontSize optional |
Typ:
string optional Domyślne:
'14px' Rozmiar czcionki tekstu etykiety (odpowiednik właściwości CSS „size_size”). |
fontWeight optional |
Typ:
string optional Grubość czcionki tekstu etykiety (odpowiednik właściwości CSS „weight-weight”). |
Interfejs MarkerShape
google.maps.MarkerShape
interfejs
Ten obiekt określa region obrazu znacznika, który można kliknąć. Kształt składa się z 2 właściwości type
i coord
, które określają nieprzezroczysty region obrazu.
Właściwości | |
---|---|
coords |
Typ:
Array<number> Format tego atrybutu zależy od wartości parametru type i jest zgodny ze specyfikacją obszaru W3 coords dostępną na stronie http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. Atrybut coords to tablica liczb całkowitych określająca położenie piksela w porównaniu do lewego górnego rogu obrazu docelowego. Współrzędne zależą od wartości type w ten sposób: – circle : współrzędne to [x1,y1,r] , gdzie x1,y2 to współrzędne okręgu, a r jest promieniem okręgu. – poly : współrzędne to [x1,y1,x2,y2...xn,yn] , w których każda x, y zawiera współrzędne jednego wierzchołka wielokąta. rect [x1,y1,x2,y2] |
type |
Typ:
string Opisuje typ kształtu i może mieć postać circle , poly lub rect . |
Symbol
google.maps.Symbol
interfejs
Opisuje symbol, który składa się ze ścieżki wektorowej odpowiadającej stylizacji. Symbolu można użyć jako ikony znacznika lub dodać do linii łamanej.
Właściwości | |
---|---|
path |
Typ:
SymbolPath|string Ścieżka symbolu, która jest wbudowaną ścieżką symbolu, lub niestandardowa ścieżka wyrażona w notacji ścieżki SVG. Wymagany. |
anchor optional |
Typ:
Point optional Domyślne:
google.maps.Point(0,0) Pozycja symbolu w stosunku do znacznika lub linii łamanej. Współrzędne ścieżki symbolu są przesuwane odpowiednio w lewo i w górę przez współrzędne x i y kotwicy. Pozycja jest wyrażona w tym samym systemie 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 nazwanych. W przypadku znaczników symboli domyślnie ustawiona jest wartość „czarny”. W przypadku symboli na liniach łamanych domyślnie jest używany kolor kreski odpowiedniej linii łamanej. |
fillOpacity optional |
Typ:
number optional Domyślne:
0 Przezroczystość wypełnienia symbolu. |
labelOrigin optional |
Typ:
Point optional Domyślne:
google.maps.Point(0,0) Źródło etykiety w porównaniu do punktu początkowego ścieżki, jeśli etykieta została podana przez znacznik. Źródło jest wyrażone w tym samym systemie współrzędnych co ścieżka symbolu. Ta właściwość nie jest używana w przypadku linii łamanych. |
rotation optional |
Typ:
number optional Domyślne:
0 Kąt, o jaki ma być obracany symbol, wyrażony w stopniach w prawo. Symbol w miejscu IconSequence , w którym fixedRotation to false , jest obrócony względem kąta krawędzi, na której się on znajduje. |
scale optional |
Typ:
number optional Wielkość, o jaką symbol jest skalowany. W przypadku znaczników symboli przyjmuje domyślną wartość 1. Po skalowaniu symbol może mieć dowolny rozmiar. W przypadku symboli na linii łamanej domyślna wartość to kreska kreski. Po skalowaniu symbol musi znajdować się wewnątrz kwadratu o wymiarach 22 pikseli wyśrodkowanego na zakotwiczeniu symbolu. |
strokeColor optional |
Typ:
string optional Kolor kreski symbolu Obsługiwane są wszystkie kolory CSS3 z wyjątkiem rozszerzonych nazw nazwanych. W przypadku znaczników symboli domyślnie ustawiona jest wartość „czarny”. W przypadku symboli na linii łamanej jest to domyślny kolor linii łamanej. |
strokeOpacity optional |
Typ:
number optional Przezroczystość kreski symbolu. W przypadku znaczników symboli domyślnie przyjmuje się wartość 1. W przypadku symboli na linii łamanej domyślnie wybierana jest przezroczystość kreski linii łamanej. |
strokeWeight optional |
Typ:
number optional Domyślny:
Symbol.scale znaku.Waga kreski symbolu |
stałe SymbolPath
google.maps.SymbolPath
stałe
Wbudowane ścieżki symboli.
Zadzwoń pod numer const {SymbolPath} = await google.maps.importLibrary("core")
, aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
BACKWARD_CLOSED_ARROW |
Strzałka w lewo zamknięta. |
BACKWARD_OPEN_ARROW |
Strzałka otwarta do tyłu. |
CIRCLE |
Kółko. |
FORWARD_CLOSED_ARROW |
Strzałka zamknięta skierowana do przodu. |
FORWARD_OPEN_ARROW |
Strzałka otwarta do przodu. |
Stałe animacji
google.maps.Animation
stałe
Animacje, które można odtwarzać na znaczniku. Użyj metody Marker.setAnimation
w znacznikach lub opcji MarkerOptions.animation
, aby odtworzyć animację.
Zadzwoń pod numer const {Animation} = await google.maps.importLibrary("marker")
, aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
BOUNCE |
Znacznik jest odsyłany do momentu zatrzymania animacji, wywołując Marker.setAnimation za pomocą null . |
DROP |
Znacznik jest usuwany z góry mapy do pozycji końcowej. Animacja przestanie działać, gdy znacznik znajdzie się w spoczynku. Wskaźnik Marker.getAnimation zwróci null . Ten typ animacji jest zwykle określany podczas tworzenia znacznika. |