Marker

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.

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.
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.
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
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ę, 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
Pobierz kształt elementów Marker używanych do interakcji. Zobacz MarkerOptions.shape i MarkerShape.
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: 
  • animationAnimation optional animacja do odtworzenia.
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: 
  • flagboolean Jeśli true, można kliknąć znacznik.
Zwracana wartość: brak
Ustaw, czy Marker można kliknąć.
setCursor
setCursor([cursor])
Parametry: 
  • cursorstring optional typ kursora myszy.
Zwracana wartość: brak
Ustaw typ kursora wyświetlanego po najechaniu.
setDraggable
setDraggable(flag)
Parametry: 
  • flagboolean optional Jeśli ma wartość true, można przeciągnąć znacznik.
Zwracana wartość: brak
Ustaw, czy element Marker można przeciągać.
setIcon
setIcon([icon])
Parametry: 
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: 
  • opacitynumber optional liczba od 0, 0 przezroczysty do 1, 0, nieprzezroczysty.
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
Ustaw kształt interfejsu Marker używanego do interakcji. Zobacz MarkerOptions.shape i MarkerShape.
setTitle
setTitle([title])
Parametry: 
  • titlestring optional
Zwracana wartość: brak
Ustaw tytuł etykietki Marker. Zobacz MarkerOptions.title.
setVisible
setVisible(visible)
Parametry: 
  • visibleboolean Jeśli true, znacznik jest widoczny
Zwracana wartość: brak
Ustaw, czy Marker jest widoczny.
setZIndex
setZIndex([zIndex])
Parametry: 
  • zIndexnumber optional
Zwracana wartość: brak
Ustaw kolejność nakładania elementów (Marker). Zobacz MarkerOptions.zIndex.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
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.
rightclick
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.

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.
BetacollisionBehavior optional
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
Typ:  string|Icon|Symbol 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.

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.

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.

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.

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.

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.

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.

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.