Klasa Marker
google.maps.Marker
zajęcia
Ta klasa stanowi rozszerzenie MVCObject
.
Uzyskaj dostęp, dzwoniąc pod numer const {Marker} = await google.maps.importLibrary("marker")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
Marker |
Marker([opts]) Parametry:
Tworzy znacznik z określonymi opcjami. Jeśli określisz mapę, znacznik zostanie do niej dodany po utworzeniu mapy. Pamiętaj, że aby znacznik został wyświetlony, musi być ustawiona pozycja. |
Stałe | |
---|---|
MAX_ZINDEX |
Maksymalna domyślna wartość kolejności nakładania elementów, którą interfejs API przypisze do znacznika. Możesz ustawić większą kolejność nakładania elementów, by znacznik znalazł się na pierwszym planie. |
Metody | |
---|---|
getAnimation |
getAnimation() Parametry: brak
Zwracana wartość:
Animation|null|undefined Pobierz aktualnie uruchomioną animację. |
getClickable |
getClickable() Parametry: brak
Zwracana wartość:
boolean ma wartość Prawda, jeśli znacznik jest klikalny.Sprawdź możliwy do kliknięcia stan elementu Marker . |
getCursor |
getCursor() Parametry: brak
Zwracana wartość:
string|null|undefined Ustaw typ kursora myszy widoczny po najechaniu. |
getDraggable |
getDraggable() Parametry: brak
Wartość zwracana:
boolean ma wartość Prawda, jeśli znacznik jest przeciągany.Pobierz stan elementu Marker , który można przeciągać. |
getIcon |
getIcon() Parametry: brak
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ę, w której renderowany jest element Marker . |
getOpacity |
getOpacity() Parametry: brak
Zwracana wartość:
number|null|undefined liczba od 0,0 do 1,0.Uzyskaj nieprzezroczystość parametru Marker . |
getPosition |
getPosition() Parametry: brak
Zwracana wartość:
LatLng|null|undefined Uzyskaj informacje o położeniu obiektu Marker . |
getShape |
getShape() Parametry: brak
Zwracana wartość:
MarkerShape|null|undefined |
getTitle |
getTitle() Parametry: brak
Zwracana wartość:
string|null|undefined Pobierz tytuł etykietki Marker . Zobacz MarkerOptions.title . |
getVisible |
getVisible() Parametry: brak
Zwracana wartość:
boolean Prawda, jeśli znacznik jest widoczny.Sprawdź: Marker . |
getZIndex |
getZIndex() Parametry: brak
Wartość zwrotna:
number|null|undefined zIndex znacznika.Pobierz wskaźnik ZIndex dla Marker . Zobacz MarkerOptions.zIndex . |
setAnimation |
setAnimation([animation]) Parametry:
Zwracana wartość: brak
Rozpocznij animację. Wszystkie trwające animacje zostaną anulowane. Obecnie obsługiwane animacje to: Animation.BOUNCE , Animation.DROP . Jeśli prześlesz null , animacja zostanie zatrzymana. |
setClickable |
setClickable(flag) Parametry:
Zwracana wartość: brak
Ustaw, czy Marker można kliknąć. |
setCursor |
setCursor([cursor]) Parametry:
Zwracana wartość: brak
Ustaw typ kursora wyświetlanego po najechaniu. |
setDraggable |
setDraggable(flag) Parametry:
Zwracana wartość: brak
Ustaw, czy element Marker można przeciągać. |
setIcon |
setIcon([icon]) Zwracana wartość: brak
Ustaw ikonę dla: Marker . Zobacz MarkerOptions.icon . |
setLabel |
setLabel([label]) Parametry:
Zwracana wartość: brak
Ustaw etykietę elementu Marker . Zobacz MarkerOptions.label . |
setMap |
setMap(map) Parametry:
Zwracana wartość: brak
Renderuje Marker na wskazanej mapie lub w wybranej panoramie. Jeśli mapa jest ustawiona na 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 atrybutu Marker . |
setPosition |
setPosition([latlng]) Parametry:
Zwracana wartość: brak
Ustaw posta dla: 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
Ustaw, czy Marker jest widoczny. |
setZIndex |
setZIndex([zIndex]) Parametry:
Zwracana wartość: brak
Ustaw kolejność nakładania elementów ( 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 zmieni się właściwość 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 klikalnej Marker . |
contextmenu |
function(event) Argumenty:
To zdarzenie jest wywoływane po wywołaniu zdarzenia menu kontekstowego DOM na stronie 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 wielokrotnie wywoływane, gdy użytkownik przeciąga Marker . |
dragend |
function(event) Argumenty:
To zdarzenie jest uruchamiane, 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 Marker . |
dragstart |
function(event) Argumenty:
To zdarzenie jest uruchamiane, gdy użytkownik zaczyna przeciągać element Marker . |
flat_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości płaskiej 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 po najechaniu kursorem myszy na element Marker . |
mouseout |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy kursor myszy opuści obszar ikony Marker . |
mouseover |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy kursor myszy znajdzie się w obszarze ikony Marker . |
mouseup |
function(event) Argumenty:
To zdarzenie jest wywoływane po najechaniu kursorem myszy na element Marker . |
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 wywoływane po zmianie widocznej właściwości Marker . |
zindex_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości Marker zIndex. |
|
function(event) Argumenty:
To zdarzenie jest wywoływane po kliknięciu prawym przyciskiem myszy elementu Marker . |
Interfejs MarkerOptions
google.maps.MarkerOptions
interfejs
Obiekt MarkOptions 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 znacznika od pozycji znacznika do końca otwartego okna InfoWindow, w którym znacznik był zakotwiczoną. |
animation optional |
Typ:
Animation optional Wartość domyślna:
null Animacja, która ma być odtwarzana po dodaniu znacznika do mapy. |
clickable optional |
Typ:
boolean optional Wartość domyślna:
true Jeśli ustawiona jest wartość true , znacznik otrzymuje zdarzenia myszy i kliknięcia. |
|
Typ:
string|CollisionBehavior optional Wartość domyślna:
null Określ działanie związane z kolizją znaczników na mapach wektorowych. |
crossOnDrag optional |
Typ:
boolean optional Wartość domyślna:
true Jeśli ustawiona jest wartość false , wyłącza krzyżyk, który pojawia się pod znacznikiem podczas przeciągania. |
cursor optional |
Typ:
string optional Wartość domyślna:
pointer Typ kursora myszy wyświetlany po najechaniu. |
draggable optional |
Typ:
boolean optional Wartość domyślna:
false Jeśli ustawiona jest wartość true , można przeciągnąć znacznik. |
icon optional |
Ikona pierwszego planu. Jeśli podasz ciąg znaków, będzie on traktowany tak, jakby był to typ Icon z parametrem url . |
label optional |
Typ:
string|MarkerLabel optional Wartość domyślna:
null Dodaje etykietę do znacznika. Etykieta znacznika to litera lub cyfra wyświetlana wewnątrz znacznika. Etykieta może być ciągiem znaków lub obiektem MarkerLabel . Jeśli zostanie podany, a MarkerOptions.title nie zostanie podany, do znacznika zostanie dodany tekst ułatwień dostępu (np. do wykorzystania z czytnikami ekranu) z tekstem tej etykiety. Pamiętaj, że właściwość label jest obecnie używana tylko w przypadku tekstu ułatwień dostępu w przypadku niezoptymalizowanych 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 zostać dostarczona z wartością Marker.setMap , jeśli nie została podana podczas tworzenia znacznika. |
opacity optional |
Typ:
number optional Wartość domyślna: 1,0
Liczba od 0, 0 przezroczysty do 1, 0, nieprzezroczysty. |
optimized optional |
Typ:
boolean optional Optymalizacja zwiększa skuteczność, ponieważ renderuje 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. |
position optional |
Typ:
LatLng|LatLngLiteral optional Określa pozycję znacznika. Znacznik może zostać utworzony, ale nie będzie wyświetlany, dopóki nie zostanie określona jego pozycja, np. w wyniku działań lub wyborów użytkownika. Jeśli podczas budowy znacznika nie podano tej wartości, położenie znacznika można podać jako Marker.setPosition . |
shape optional |
Typ:
MarkerShape optional Definicja regionu mapy obrazu używana do przeciągania/klikania. |
title optional |
Typ:
string optional Wartość domyślna:
undefined Tekst, który wyświetla się po najechaniu kursorem. Jeśli zostanie podany, do znacznika zostanie dodany tekst ułatwień dostępu (np. do używania z czytnikami ekranu) z podaną wartością. Pamiętaj, że właściwość title jest obecnie używana tylko w przypadku tekstu ułatwień dostępu w przypadku niezoptymalizowanych znaczników. |
visible optional |
Typ:
boolean optional Wartość domyślna:
true Jeśli ustawiona jest wartość true , znacznik jest widoczny. |
zIndex optional |
Typ:
number optional Wszystkie znaczniki są wyświetlane na mapie w kolejności ich zIndex – wyższe wartości są wyświetlane przed tymi o niższych wartościach. Domyślnie znaczniki są wyświetlane zgodnie z ich umiejscowieniem w pionie na ekranie. Dolne znaczniki znajdują się przed znacznikami w dalszej części ekranu. |
Stałe CollisionBehavior
google.maps.CollisionBehavior
stałe
Uzyskaj dostęp, dzwoniąc pod numer const {CollisionBehavior} = await google.maps.importLibrary("marker")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
OPTIONAL_AND_HIDES_LOWER_PRIORITY |
Wyświetl znacznik tylko wtedy, gdy nie pokrywa się z innymi znacznikami. Jeśli dwa znaczniki tego typu nakładają się, wyświetlany jest ten o wyższym wskaźniku ZIndex. Jeśli mają jednakową wartość zIndex, wyświetlana jest ta, która znajduje się niżej na ekranie w pionie. |
REQUIRED |
Znacznik jest zawsze wyświetlany niezależnie od kolizji. Jest to jego ustawienie domyślne. |
REQUIRED_AND_HIDES_OPTIONAL |
Zawsze wyświetlaj znacznik niezależnie od kolizji i ukryj wszystkie znaczniki OPTIONAL_AND_HIDES_LOWER_PRIORITY lub etykiety, które mogą się ze nim nakładać. |
Interfejs ikony
google.maps.Icon
interfejs
Struktura reprezentująca obraz ikony znacznika.
Właściwości | |
---|---|
url |
Typ:
string URL obrazu lub arkusza sprite. |
anchor optional |
Typ:
Point optional Pozycja, w której zakotwiczyć obraz odpowiadający lokalizacji znacznika na mapie. Domyślnie kotwica znajduje się w środku u dołu obrazu. |
labelOrigin optional |
Typ:
Point optional Pochodzenie etykiety względem lewego górnego rogu obrazu ikony, jeśli etykieta jest dostarczana przez znacznik. Domyślnie punkt początkowy znajduje się w środkowym punkcie zdjęcia. |
origin optional |
Typ:
Point optional Pozycja obrazu w sprite’u (jeśli istnieje). 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 przeskalowaniu, jeśli taki istnieje. Ta właściwość służy do rozciągania/zmniejszania obrazu lub sprite’a. |
size optional |
Typ:
Size optional Rozmiar wyświetlanego sprite’a lub obrazu. Jeśli używasz sprite’ów, musisz określić ich rozmiar. Jeśli rozmiar nie zostanie określony, 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 (często pojedynczy znak), który będzie wyświetlany wewnątrz znacznika. Jeśli używasz go ze znacznikiem niestandardowym, 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 do wyświetlania w etykiecie. |
className optional |
Typ:
string optional Wartość domyślna:
'' (pusty ciąg znaków)Właściwość className elementu etykiety (odpowiednika atrybutu klasy elementu). Możesz dodać wiele klas CSS rozdzielonych spacjami. Kolor, rozmiar, grubość i rodzinę czcionki można ustawić tylko w innych właściwościach MarkerLabel . Jeśli korzystasz też z zarządzania kolizją znaczników, nie używaj klas CSS do zmiany pozycji ani orientacji etykiety (np. przy użyciu przesunięcia i obrotu). |
color optional |
Typ:
string optional Wartość domyślna:
'black' Kolor tekstu etykiety. |
fontFamily optional |
Typ:
string optional Rodzina czcionek tekstu etykiety (odpowiada właściwości rodziny czcionek CSS). |
fontSize optional |
Typ:
string optional Wartość domyślna:
'14px' Rozmiar czcionki tekstu etykiety (odpowiada właściwości CSS font-size). |
fontWeight optional |
Typ:
string optional Grubość czcionki tekstu etykiety (odpowiada właściwości CSS font-weight). |
Interfejs Marker shape
google.maps.MarkerShape
interfejs
Ten obiekt definiuje klikalny obszar 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 | |
---|---|
coords |
Typ:
Array<number> Format tego atrybutu zależy od wartości atrybutu type i jest zgodny ze specyfikacją w3 OBSZARU OBSZARU coords pod adresem http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. Atrybut coords to tablica liczb całkowitych, które określają położenie w pikselach kształtu względem 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 środka koła, a r to promień koła. – poly : współrzędne mają wartość [x1,y1,x2,y2...xn,yn] , gdzie każda para x,y zawiera współrzędne jednego wierzchołka wielokąta. – rect : współrzędne 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 jego prawego dolnego rogu. |
type |
Typ:
string Opisuje typ kształtu i może to być circle , poly lub rect . |
Interfejs symboli
google.maps.Symbol
interfejs
Opisuje symbol, który składa się ze ścieżki wektorowej ze stylem. Symbol może być używany jako ikona znacznika lub na linii łamanej.
Właściwości | |
---|---|
path |
Typ:
SymbolPath|string Ścieżka symbolu, która jest wbudowaną ścieżką symboli, lub ścieżka niestandardowa wyrażona w notacji ścieżki SVG. To pole jest wymagane. |
anchor optional |
Typ:
Point optional Wartość domyślna:
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ę przez współrzędne x i y kotwicy. Położenie jest wyrażane 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 kolorów nazwanych. W przypadku znaczników symboli ta wartość jest domyślna, czyli „czarny”. W przypadku symboli na liniach łamanych wartość domyślna to kolor kreski odpowiedniej linii łamanej. |
fillOpacity optional |
Typ:
number optional Wartość domyślna:
0 Przezroczystość wypełnienia symbolu. |
labelOrigin optional |
Typ:
Point optional Wartość domyślna:
google.maps.Point(0,0) Pochodzenie etykiety względem początku ścieżki, jeśli etykieta jest dostarczana przez znacznik. Punkt początkowy jest określony 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 optional |
Typ:
number optional Wartość domyślna:
0 Kąt, o jaki obrócisz symbol, wyrażony w stopniach w prawo. Symbol w elemencie IconSequence , gdzie fixedRotation ma wartość false , jest obracany względem kąta krawędzi, na której się znajduje. |
scale optional |
Typ:
number optional Wielkość, o którą symbol jest skalowany. W przypadku znaczników symboli ma wartość domyślną, czyli 1. Po skalowaniu symbol może mieć dowolny rozmiar. W przypadku symboli na linii łamanej domyślnie jest to waga kreski linii łamanej. Po przeskalowaniu symbol musi znajdować się wewnątrz kwadratu o rozmiarze 22 pikseli wyśrodkowanym na zakotwiczeniach symbolu. |
strokeColor optional |
Typ:
string optional Kolor kreski symbolu. Obsługiwane są wszystkie kolory CSS3 z wyjątkiem rozszerzonych kolorów nazwanych. W przypadku znaczników symboli ta wartość jest domyślna, czyli „czarny”. W przypadku symboli na linii łamanej domyślnie jest to kolor kreski linii łamanej. |
strokeOpacity optional |
Typ:
number optional Przezroczystość kreski symbolu. W przypadku znaczników symboli ma wartość domyślną 1. W przypadku symboli na linii łamanej domyślnie przyjmuje się przezroczystość kreski linii łamanej. |
strokeWeight optional |
Typ:
number optional Wartość domyślna:
Symbol.scale symbolu.Grubość kreski znaku. |
Stałe SymbolPath
google.maps.SymbolPath
stałe
Wbudowane ścieżki symboli.
Uzyskaj dostęp, dzwoniąc pod numer const {SymbolPath} = await google.maps.importLibrary("core")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
BACKWARD_CLOSED_ARROW |
Zamknięta strzałka skierowana do tyłu. |
BACKWARD_OPEN_ARROW |
Otwarta strzałka skierowana do tyłu. |
CIRCLE |
Kółko. |
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. Aby odtworzyć animację, użyj metody Marker.setAnimation
w znaczniku lub opcji MarkerOptions.animation
.
Uzyskaj dostęp, dzwoniąc pod numer const {Animation} = await google.maps.importLibrary("marker")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
BOUNCE |
Znacznik będzie skakać, dopóki animacja nie zostanie zatrzymana, wywołując metodę Marker.setAnimation za pomocą polecenia null . |
DROP |
Znacznik zostanie przesunięty z góry mapy do jego ostatecznego położenia. Animacja zostanie przerwana, gdy znacznik zatrzyma się, a Marker.getAnimation zwróci wartość null . Ten typ animacji jest zwykle określany podczas tworzenia znacznika. |