Marker

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.
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ł.
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
Wartość zwrotu:  string|Icon|Symbol|null|undefined
Pobierz ikonę: Marker. Zobacz MarkerOptions.icon.
getLabel
getLabel()
Parametry: brak
Wartość zwrotu:  MarkerLabel|string|null|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|undefinedzindex znacznika.
Pobieranie parametru zKolejność wartości parametru Marker. Zobacz MarkerOptions.zIndex.
setAnimation
setAnimation([animation])
Parametry: 
  • animation:  Animation optional Animacja do odtworzenia.
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: 
  • flag:  boolean Jeśli true, znacznik będzie 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, który jest pokazywany po najechaniu kursorem.
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: 
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: 
  • opacity:  number optional Liczba z zakresu od 0,0 przezroczysty do 1,0 – nieprzezroczysta.
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
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 będzie widoczny
Zwracana wartość: brak
Określ, czy Marker jest widoczny.
setZIndex
setZIndex([zIndex])
Parametry: 
  • zIndex:  number optional
Zwracana wartość: brak
Ustaw kolejność nakładania elementów dla elementu Marker. Zobacz MarkerOptions.zIndex.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
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.
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.
rightclick
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.
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.
BetacollisionBehavior optional
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
Typ:  string|Icon|Symbol 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.
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.
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.
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.
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.
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.
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.
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.