Marker (legacy)

Znacznik:

google.maps.Marker class

Te zajęcia trwają MVCObject.

Dostęp przez połączenie telefoniczne const {Marker} = await google.maps.importLibrary("marker"). Zobacz Biblioteki w Maps JavaScript API.

Marker
Marker([opts])
Parametry: 
Tworzy znacznik z określonymi opcjami. Jeśli zostanie określona mapa, znacznik zostanie dodany do niej po utworzeniu roboty drogowej. Pamiętaj, że aby znacznik był widoczny, musisz ustawić jego pozycję.
MAX_ZINDEX Maksymalny domyślny indeks z, który interfejs API przypisze do znacznika. Aby przesunąć znacznik na pierwszy plan, możesz ustawić wyższą wartość wskaźnika z-index.
getAnimation
getAnimation()
Parametry: brak
Wartość zwracana:  Animation|null|undefined
Pobierz aktualnie odtwarzaną animację.
getClickable
getClickable()
Parametry: brak
Zwracana wartość:  boolean Prawda, jeśli znacznik jest klikalny.
Uzyskaj informacje o tym, czy element Marker jest klikalny.
getCursor
getCursor()
Parametry: brak
Wartość zwracana:  string|null|undefined
Wybierz typ kursora myszy wyświetlany po najechaniu.
getDraggable
getDraggable()
Parametry: brak
Zwracana wartość:  boolean Prawda, jeśli znacznik można przeciągać.
Uzyskaj informację o możliwości przeciągania elementu Marker.
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
Pobierz mapę lub panoramę, na której renderowany jest 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
Pobierz pozycję Marker.
getShape
getShape()
Parametry: brak
Wartość zwracana:  MarkerShape|null|undefined
Pobierz kształt Marker używany do interakcji. Zobacz MarkerOptions.shapeMarkerShape.
getTitle
getTitle()
Parametry: brak
Wartość zwracana:  string|null|undefined
Pobierz tytuł Marker. Zobacz MarkerOptions.title.
getVisible
getVisible()
Parametry: brak
Wartość zwracana:  boolean Prawda, jeśli znacznik jest widoczny.
Sprawdź widoczność Marker.
getZIndex
getZIndex()
Parametry: brak
Zwracana wartość:  number|null|undefined zIndex znacznika.
Pobierz z-index elementu Marker. Zobacz MarkerOptions.zIndex.
setAnimation
setAnimation([animation])
Parametry: 
  • animationAnimation optional animacja do odtworzenia.
Zwracana wartość:  brak
Uruchom animację. Każda trwająca animacja zostanie anulowana. Obecnie obsługiwane animacje to: Animation.BOUNCE, Animation.DROP. Podanie wartości null spowoduje zatrzymanie animacji.
setClickable
setClickable(flag)
Parametry: 
  • flagboolean Jeśli true, można kliknąć znacznik.
Zwracana wartość:  brak
Określa, czy element Marker jest klikalny.
setCursor
setCursor([cursor])
Parametry: 
  • cursorstring optional typ kursora myszy.
Zwracana wartość:  brak
Ustaw typ kursora myszy wyświetlany po najechaniu.
setDraggable
setDraggable(flag)
Parametry: 
  • flagboolean optional Jeśli true, znacznik można przeciągać.
Zwracana wartość:  brak
Ustaw, 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 zasobu Marker. Zobacz MarkerOptions.label.
setMap
setMap(map)
Parametry: 
Zwracana wartość:  brak
Renderuje Marker na określonej mapie lub panoramie. Jeśli mapa ma wartość null, znacznik zostanie usunięty.
setOpacity
setOpacity([opacity])
Parametry: 
  • opacitynumber optional Liczba z zakresu od 0,0 (przezroczysta) do 1,0 (nieprzezroczysta).
Zwracana wartość:  brak
Ustaw przezroczystość Marker.
setOptions
setOptions(options)
Parametry: 
Zwracana wartość:  brak
Skonfiguruj opcje Marker.
setPosition
setPosition([latlng])
Parametry: 
Zwracana wartość:  brak
Ustaw pozycję Marker.
setShape
setShape([shape])
Parametry: 
Zwracana wartość:  brak
Ustaw kształt Marker używany do interakcji. Zobacz MarkerOptions.shapeMarkerShape.
setTitle
setTitle([title])
Parametry: 
  • titlestring optional
Zwracana wartość:  brak
Ustaw tytuł Marker. Zobacz MarkerOptions.title.
setVisible
setVisible(visible)
Parametry: 
  • visibleboolean Jeśli true, znacznik jest widoczny
Zwracana wartość:  brak
Ustaw, czy Marker ma być widoczny.
setZIndex
setZIndex([zIndex])
Parametry: 
  • zIndexnumber optional
Zwracana wartość:  brak
Ustaw indeks z poziomu Z elementu Marker. Zobacz MarkerOptions.zIndex.
Uzyskane: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
animation_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia 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, gdy zmienia się właściwość Marker, która może być klikana.
contextmenu
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy zdarzenie menu kontekstowego DOM zostanie wywołane na elemencie Marker.
cursor_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się właściwość 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 element Marker.
dragend
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy użytkownik przestanie 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: 
To zdarzenie jest wywoływane, gdy użytkownik zacznie 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: 
To zdarzenie jest wywoływane po naciśnięciu przycisku Marker.
mouseout
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy wskaźnik myszy opuszcza 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 zwolnieniu przycisku myszy na elemencie Marker.
position_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się wartość właściwości Marker.
shape_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się właściwość Marker shape.
title_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się wartość właściwości Marker title.
visible_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się wartość właściwości Marker visible.
zindex_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się wartość właściwości Marker zIndex.
rightclick
function(event)
Argumenty: 
To zdarzenie jest wywoływane po kliknięciu prawym przyciskiem myszy Marker.

Interfejs MarkerOptions

google.maps.MarkerOptionsinterfejs

Obiekt MarkerOptions służy do definiowania właściwości, które można ustawić w przypadku obiektu Marker.

anchorPoint optional
Typ:  Point optional
Odsunięcie od pozycji znacznika do wierzchołka okna informacyjnego, które zostało otwarte z użyciem znacznika jako punktu zaczepienia.
animation optional
Typ:  Animation optional
Domyślnie: null
Animacja, która ma się odtworzyć, gdy znacznik zostanie dodany do mapy.
clickable optional
Typ:  boolean optional
Domyślnie: true
Jeśli true, znacznik odbiera zdarzenia myszy i dotyku.
BetacollisionBehavior optional
Typ:  string|CollisionBehavior optional
Domyślnie: null
Ustaw zachowanie punktów na mapach wektorowych w przypadku kolizji.
crossOnDrag optional
Typ:  boolean optional
Domyślnie: true
Jeśli false, wyłącza krzyżyk, który pojawia się pod znacznikiem podczas przeciągania.
cursor optional
Typ:  string optional
Domyślnie: pointer
Typ kursora myszy, który ma się wyświetlać po najechaniu.
draggable optional
Typ:  boolean optional
Domyślnie: false
Jeśli true, można przeciągać znacznik.
icon optional
Typ:  string|Icon|Symbol optional
Ikona pierwszego planu. Jeśli podany jest ciąg znaków, jest on traktowany jak Icon, a ciąg znaków jako url.
label optional
Typ:  string|MarkerLabel optional
Domyślnie: 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 etykieta jest podana, a etykieta ułatwień dostępu nie, do markera zostanie dodany tekst ułatwień dostępu (np. na potrzeby czytników ekranu) z tekstem podanej etykiety.MarkerOptions.title Pamiętaj, że label jest obecnie używany tylko do tekstu ułatwiającego dostęp dla nieoptymalizowanych znaczników.
map optional
Typ:  Map|StreetViewPanorama optional
Mapa, na której ma być wyświetlany znacznik. Mapa jest wymagana do wyświetlania znacznika i może być przekazana za pomocą Marker.setMap, jeśli nie została podana podczas tworzenia znacznika.
opacity optional
Typ:  number optional
Domyślna wartość: 1,0
Liczba z zakresu od 0,0 (przezroczysta) do 1,0 (nieprzezroczysta).
optimized optional
Typ:  boolean optional
Optymalizacja zwiększa wydajność, ponieważ renderuje wiele znaczników jako pojedynczy element statyczny. Jest to przydatne w przypadku dużej liczby znaczników. Dowiedz się więcej o optymalizacji znaczników.
position optional
Typ:  LatLng|LatLngLiteral optional
Ustawia pozycję znacznika. znacznik może być utworzony, ale nie jest wyświetlany, dopóki nie zostanie podana jego pozycja – na przykład przez działania lub wybory użytkownika; Pozycja znacznika może być podana za pomocą atrybutu Marker.setPosition, jeśli nie została podana podczas tworzenia znacznika.
shape optional
Typ:  MarkerShape optional
Definicja regionu mapy obrazkowej używana do przeciągania i klikania.
title optional
Typ:  string optional
Domyślnie: undefined
Tekst najechania kursorem. Jeśli zostanie podany, do znacznika zostanie dodany tekst ułatwień dostępu (np. do użycia z czytnikami ekranu) z podaną wartością. Pamiętaj, że title jest obecnie używany tylko do tekstu ułatwiającego dostęp dla nieoptymalizowanych znaczników.
visible optional
Typ:  boolean optional
Domyślnie: true
Jeśli true, znacznik jest widoczny.
zIndex optional
Typ:  number optional
Wszystkie znaczniki są wyświetlane na mapie w kolejności zIndex, przy czym znaczniki o większych wartościach wyświetlają się przed znacznikami o mniejszych wartościach. Domyślnie znaczniki są wyświetlane zgodnie z ich położeniem pionowym na ekranie, a znaczniki znajdujące się niżej pojawiają się przed tymi, które są wyżej.

Stałe CollisionBehavior

google.maps.CollisionBehavior stałe

Dostęp przez połączenie telefoniczne const {CollisionBehavior} = await google.maps.importLibrary("marker"). Zobacz Biblioteki w Maps JavaScript API.

OPTIONAL_AND_HIDES_LOWER_PRIORITY Wyświetlać znacznik tylko wtedy, gdy nie nakłada się on na inne znaczniki. Jeśli 2 takie znaczniki nakładają się na siebie, wyświetla się ten o większym zIndex. Jeśli mają ten sam parametr zIndex, wyświetlany jest element o niższej pozycji na ekranie.
REQUIRED zawsze wyświetlać znacznik niezależnie od kolizji; Jest to zachowanie domyślne.
REQUIRED_AND_HIDES_OPTIONAL Zawsze wyświetlaj znacznik niezależnie od kolizji i ukrywanie wszelkich znaczników lub etykiet OPTIONAL_AND_HIDES_LOWER_PRIORITY, które nakładają się na znacznik.

Ikonainterfejsu

google.maps.Iconinterfejs

Struktura reprezentująca obraz ikony znacznika.

url
Typ:  string
Adres URL obrazu lub arkusza sprite.
anchor optional
Typ:  Point optional
Pozycja, w której obraz ma być zakotwiczony w zależności od lokalizacji znacznika na mapie. Domyślnie kotwnik znajduje się na środku dołu obrazu.
labelOrigin optional
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 optional
Typ:  Point optional
Położenie obrazu w ramach sprite’a (jeśli występuje). 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 skalowaniu (jeśli było ono zastosowane). Za pomocą tej właściwości możesz rozciągać lub zmniejszać obraz lub sprite.
size optional
Typ:  Size optional
Rozmiar sprite’a lub obrazu. Jeśli używasz sprite’ów, musisz podać ich rozmiar. Jeśli rozmiar nie zostanie podany, zostanie ustawiony podczas wczytywania obrazu.

Interfejs MarkerLabel

google.maps.MarkerLabelinterfejs

Te opcje określają wygląd etykiety znacznika. Etykieta znacznika to ciąg znaków (często pojedynczy znak), który będzie widoczny wewnątrz znacznika. Jeśli używasz go z niestandardowym znacznikiem, możesz zmienić jego położenie za pomocą właściwości labelOrigin w klasie Icon.

text
Typ:  string
Tekst do wyświetlenia na etykiecie.
className optional
Typ:  string optional
Domyślnie: '' (pusty ciąg znaków)
Właściwość className elementu etykiety (odpowiada atrybucie class elementu). Możesz dodać wiele klas CSS oddzielonych spacjami. Kolor, rozmiar, grubość i rodzina czcionki mogą być ustawiane tylko za pomocą innych właściwości MarkerLabel. Klasy CSS nie powinny służyć do zmiany pozycji ani orientacji etykiety (np. za pomocą przesunięć i obrótów), jeśli używasz też zarządzania kolizją znaczników.
color optional
Typ:  string optional
Domyślnie: 'black'
Kolor tekstu na etykiecie.
fontFamily optional
Typ:  string optional
Rodzina czcionek tekstu etykiety (odpowiada właściwości CSS font-family).
fontSize optional
Typ:  string optional
Domyślnie: '14px'
Rozmiar czcionki tekstu etykiety (odpowiada właściwości font-size w CSS).
fontWeight optional
Typ:  string optional
Grubość czcionki tekstu etykiety (odpowiednik właściwości font-weight w CSS).

Interfejs MarkerShape

google.maps.MarkerShapeinterfejs

Ten obiekt definiuje klikalny obszar obrazu znacznika. Kształt składa się z 2 właściwości: typecoord, które określają nieprzezroczysty obszar obrazu.

type
Typ:  string
Określa typ kształtu i może mieć wartość circle, poly lub rect.
coords optional
Typ:  Array<number> optional
Format tego atrybutu zależy od wartości atrybutu type i jest zgodny ze specyfikacją w3 AREA coords dostępną pod adresem http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords.
Atrybut coords to tablica liczb całkowitych, która określa położenie kształtu w pikselach względem lewego górnego rogu obrazu docelowego. Składniki 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: parametr coords ma 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 narożnika prostokąta, a x2,y2 to współrzędne prawego dolnego narożnika prostokąta.

Symbol interfejs

google.maps.Symbolinterfejs

Opisuje symbol, który składa się z ścieżki wektorowej ze stylizacją. Symbol może być używany jako ikona znacznika lub umieszczany na polilinii.

path
Typ:  SymbolPath|string
Ścieżka symbolu, która jest wbudowaną ścieżką symbolu lub ścieżką niestandardową wyrażoną za pomocą notacji ścieżki SVG. Wymagane.
anchor optional
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ą przesunięte w lewo i w górę odpowiednio o współrzędne x i y kotwicy. Pozycja jest wyrażona 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 o nazwie. W przypadku znaczników symboli domyślnie jest to kolor „czarny”. W przypadku symboli na liniach łamanych domyślnie jest to kolor obrysu odpowiadającej linii łamanej.
fillOpacity optional
Typ:  number optional
Domyślnie: 0
Przezroczystość wypełnienia symbolu.
labelOrigin optional
Typ:  Point optional
Domyślnie: google.maps.Point(0,0)
Początek etykiety w stosunku do początku ścieżki, jeśli etykieta jest dostarczana przez znacznik. Początek 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 poliliniach.
rotation optional
Typ:  number optional
Domyślnie: 0
Kąt obrotu symbolu wyrażony w stopniach zgodnie z ruchem wskazówek zegara. Symbol w IconSequence, gdzie fixedRotation = false, jest obracany względem kąta krawędzi, na której się znajduje.
scale optional
Typ:  number optional
Wielkość, o którą powiększono symbol. W przypadku znaczników symboli wartość domyślna to 1. Po skalowaniu symbol może mieć dowolny rozmiar. W przypadku symboli na polilinie domyślnie jest to grubość obrysu polilinii. Po skalowaniu symbol musi mieścić się w kwadracie o wymiarach 22 piksele, wyśrodkowanym względem punktu zakotwiczenia.
strokeColor optional
Typ:  string optional
Kolor obrysu symbolu. Obsługiwane są wszystkie kolory CSS3 z wyjątkiem rozszerzonych kolorów o nazwie. W przypadku znaczników symboli domyślnie jest to kolor „czarny”. W przypadku symboli na linii złożonej domyślnie jest to kolor obrysu linii złożonej.
strokeOpacity optional
Typ:  number optional
Przezroczystość obrysu symbolu. W przypadku znaczników symboli domyślna wartość to 1. W przypadku symboli na linii złożonej domyślnie jest to krycie obrysu linii złożonej.
strokeWeight optional
Typ:  number optional
Domyślny: Symbol.scale symbolu.
Grubość konturu symbolu.

SymbolPath stałe

google.maps.SymbolPath stałe

Wbudowane ścieżki symboli.

Dostęp przez połączenie telefoniczne const {SymbolPath} = await google.maps.importLibrary("core"). Zobacz Biblioteki w Maps JavaScript API.

BACKWARD_CLOSED_ARROW Zamknięta strzałka skierowana w tył.
BACKWARD_OPEN_ARROW Otwarta strzałka skierowana w tył.
CIRCLE okrąg,
FORWARD_CLOSED_ARROW Zamknięta strzałka skierowana do przodu.
FORWARD_OPEN_ARROW Otwarta strzałka skierowana do przodu.

Animacja stałe

google.maps.Animation stałe

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

Dostęp przez połączenie telefoniczne const {Animation} = await google.maps.importLibrary("marker"). Zobacz Biblioteki w Maps JavaScript API.

BOUNCE Marker odbija się, aż animacja zostanie zatrzymana przez wywołanie Marker.setAnimation z wartością null.
DROP Znacznik opada z góry mapy do jej docelowego położenia. Animacja zostanie zatrzymana, gdy znacznik się zatrzyma, a element Marker.getAnimation powróci do elementu null. Ten typ animacji jest zwykle określany podczas tworzenia znacznika.