Marker (legacy)

Klasa Marker

google.maps.Marker zajęcia

Ta klasa rozszerza klasę MVCObject.

Aby uzyskać dostęp, zadzwoń pod numer 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 mapa jest określona, znacznik jest dodawany do mapy podczas tworzenia. Pamiętaj, że aby znacznik się wyświetlał, musisz ustawić pozycję.
MAX_ZINDEX Maksymalny domyślny indeks Z, który interfejs API przypisze do znacznika. Możesz ustawić wyższy indeks Z, aby przesunąć znacznik na pierwszy plan.
getAnimation
getAnimation()
Parametry: brak
Wartość zwracana:  Animation|null|undefined
Pobierz aktualnie uruchomioną animację.
getClickable
getClickable()
Parametry: brak
Wartość zwracana:  boolean True, jeśli znacznik jest klikalny.
Pobierz stan klikalności elementu Marker.
getCursor
getCursor()
Parametry: brak
Wartość zwracana:  string|null|undefined
Pobierz typ kursora myszy wyświetlany po najechaniu kursorem.
getDraggable
getDraggable()
Parametry: brak
Wartość zwracana:  boolean True, jeśli znacznik można przeciągać.
Sprawdź, czy element Marker można przeciągać.
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|null
Pobierz mapę lub panoramę, na której jest renderowany element 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
Sprawdź pozycję elementu Marker.
getShape
getShape()
Parametry: brak
Wartość zwracana:  MarkerShape|null|undefined
Pobierz kształt Marker używanego do interakcji. Zobacz MarkerOptions.shape oraz MarkerShape.
getTitle
getTitle()
Parametry: brak
Wartość zwracana:  string|null|undefined
Pobierz tytuł etykietki Marker. Zobacz MarkerOptions.title.
getVisible
getVisible()
Parametry: brak
Wartość zwracana:  boolean True, jeśli znacznik jest widoczny.
Uzyskaj widoczność Marker.
getZIndex
getZIndex()
Parametry: brak
Zwracana wartość:  number|null|undefined zIndex znacznika.
Pobierz zIndex elementu Marker. Zobacz MarkerOptions.zIndex.
setAnimation
setAnimation([animation])
Parametry: 
  • animation:  Animation optional animacja do odtworzenia.
Zwracana wartość: brak
Uruchom animację. Wszystkie trwające animacje zostaną anulowane. Obecnie obsługiwane animacje to: Animation.BOUNCE, Animation.DROP. Przekazanie wartości null spowoduje zatrzymanie animacji.
setClickable
setClickable(flag)
Parametry: 
  • flag:  boolean Jeśli true, znacznik 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 wyświetlanego po najechaniu.
setDraggable
setDraggable(flag)
Parametry: 
  • flag:  boolean optional jeśli true, znacznik można przeciągać.
Zwracana wartość: brak
Określ, 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ę dla: Marker. Zobacz MarkerOptions.label.
setMap
setMap(map)
Parametry: 
Zwracana wartość: brak
Renderuje Marker na określonej mapie lub panoramie. Jeśli mapa jest ustawiona na null, znacznik zostanie usunięty.
setOpacity
setOpacity([opacity])
Parametry: 
  • opacity:  number optional liczba z zakresu od 0,0 (przezroczysty) do 1,0 (nieprzezroczysty).
Zwracana wartość: brak
Ustaw nieprzezroczystość elementu Marker.
setOptions
setOptions(options)
Parametry: 
Zwracana wartość: brak
Ustaw opcje dla Marker.
setPosition
setPosition([latlng])
Parametry: 
Zwracana wartość: brak
Ustaw pozycję dla 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 jest widoczny.
Zwracana wartość: brak
Określ, czy Marker jest widoczny.
setZIndex
setZIndex([zIndex])
Parametry: 
  • zIndex:  number optional
Zwracana wartość: brak
Ustaw zIndex elementu Marker. Zobacz MarkerOptions.zIndex.
Dziedziczone: 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 clickable.
contextmenu
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy zdarzenie contextmenu DOM jest wywoływane w obiekcie 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 wywoływane wielokrotnie, gdy użytkownik przeciąga 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, gdy zmienia się właściwość Marker draggable.
dragstart
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy użytkownik zaczyna 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 kliknięciu elementu Marker.
mouseout
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy kursor 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ę właściwość pozycji Marker.
shape_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się właściwość kształtu Marker.
title_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się właściwość tytułu Marker.
visible_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się właściwość widoczności Marker.
zindex_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się właściwość zIndex obiektu Marker.
rightclick
function(event)
Argumenty: 
To zdarzenie jest wywoływane po kliknięciu prawym przyciskiem myszy elementu Marker.

MarkerOptions interfejs

Interfejs google.maps.MarkerOptions

Obiekt MarkerOptions służący do definiowania właściwości, które można ustawić w znaczniku.
anchorPoint optional
Typ:  Point optional
Przesunięcie od pozycji znacznika do końcówki okna informacyjnego, które zostało otwarte ze znacznikiem jako kotwicą.
animation optional
Typ:  Animation optional
Domyślnie: null
Animacja, która ma być odtwarzana po dodaniu znacznika do mapy.
clickable optional
Typ:  boolean optional
Domyślnie: true
Jeśli true, znacznik odbiera zdarzenia myszy i dotknięcia.
BetacollisionBehavior optional
Typ:  string|CollisionBehavior optional
Domyślnie: null
Ustaw zachowanie przy kolizji znaczników na mapach wektorowych.
crossOnDrag optional
Typ:  boolean optional
Domyślnie: true
Jeśli ma wartość 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 być wyświetlany po najechaniu.
draggable optional
Typ:  boolean optional
Domyślnie: false
Jeśli wartość to true, znacznik można przeciągać. Uwaga: jeśli ustawisz tę wartość na true, znacznik będzie klikalny, nawet jeśli właściwość clickable będzie ustawiona na false.
icon optional
Typ:  string|Icon|Symbol optional
Ikona pierwszego planu. Jeśli podany jest ciąg znaków, jest on traktowany tak, jakby był Icon z ciągiem znaków jako url.
label optional
Typ:  string|MarkerLabel optional
Domyślnie: null
Dodaje etykietę do znacznika. Etykieta znacznika to litera lub cyfra, która pojawia się wewnątrz znacznika. Etykieta może być ciągiem znaków lub obiektem MarkerLabel. Jeśli podano tę wartość, a nie podano wartości MarkerOptions.title, do znacznika zostanie dodany tekst ułatwień dostępu (np. do użytku z czytnikami ekranu) z tekstem podanej etykiety. Pamiętaj, że label jest obecnie używany tylko w tekście 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żna ją podać za pomocą Marker.setMap, jeśli nie została podana podczas tworzenia znacznika.
opacity optional
Typ:  number optional
Wartość domyślna: 1.0
Liczba z zakresu od 0,0 (przezroczysty) do 1,0 (nieprzezroczysty).
optimized optional
Typ:  boolean optional
Optymalizacja zwiększa wydajność, renderując 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. Uwaga: ta optymalizacja nie ma wpływu na znaczniki na mapach wektorowych.
position optional
Typ:  LatLng|LatLngLiteral optional
Ustawia pozycję znacznika. Znacznik może zostać utworzony, ale nie będzie wyświetlany, dopóki nie zostanie podana jego pozycja – na przykład w wyniku działań lub wyborów użytkownika. Pozycję znacznika można podać za pomocą metody Marker.setPosition, jeśli nie została podana podczas tworzenia znacznika.
shape optional
Typ:  MarkerShape optional
Definicja regionu mapy obrazu używana do przeciągania/kliknięcia.
title optional
Typ:  string optional
Domyślnie: undefined
Tekst po najechaniu kursorem. Jeśli podasz tekst ułatwień dostępu (np. do użycia z czytnikami ekranu), zostanie on dodany do znacznika z podaną wartością. Pamiętaj, że title jest obecnie używany tylko w tekście ułatwień dostępu w przypadku niezoptymalizowanych 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 ich wartości zIndex, przy czym znaczniki o wyższych wartościach są wyświetlane przed znacznikami o niższych wartościach. Domyślnie znaczniki są wyświetlane zgodnie z ich pozycją w pionie na ekranie, przy czym znaczniki znajdujące się niżej pojawiają się przed znacznikami znajdującymi się wyżej.

Stałe CollisionBehavior

google.maps.CollisionBehavior stałe

Aby uzyskać dostęp, zadzwoń pod numer const {CollisionBehavior} = await google.maps.importLibrary("marker").
Zobacz Biblioteki w Maps JavaScript API.
OPTIONAL_AND_HIDES_LOWER_PRIORITY Wyświetlaj znacznik tylko wtedy, gdy nie nakłada się na inne znaczniki. Jeśli 2 znaczniki tego typu nakładają się na siebie, wyświetlany jest ten z wyższą wartością zIndex. Jeśli mają ten sam zIndex, wyświetlany jest ten znacznik, który znajduje się niżej na ekranie.
REQUIRED Zawsze wyświetlaj znacznik niezależnie od kolizji. Jest to działanie domyślne.
REQUIRED_AND_HIDES_OPTIONAL Zawsze wyświetlaj znacznik niezależnie od kolizji i ukrywaj wszystkie znaczniki lub etykiety OPTIONAL_AND_HIDES_LOWER_PRIORITY, które mogłyby się z nim pokrywać.

Interfejs Icon

Interfejs google.maps.Icon

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 odniesieniu do lokalizacji znacznika na mapie. Domyślnie punkt zakotwiczenia znajduje się na środku dolnej krawędzi 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
Pozycja obrazu w duszku (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 ewentualnym przeskalowaniu. Użyj tej właściwości, aby rozciągnąć lub zmniejszyć obraz albo duszka.
size optional
Typ:  Size optional
Rozmiar wyświetlania duszka lub obrazu. Jeśli używasz duszków, musisz określić ich rozmiar. Jeśli rozmiar nie zostanie podany, zostanie ustawiony podczas wczytywania obrazu.

Interfejs MarkerLabel

Interfejs google.maps.MarkerLabel

Te opcje określają wygląd etykiety znacznika. Etykieta znacznika to ciąg znaków (często pojedynczy znak), który pojawi się wewnątrz znacznika. Jeśli używasz go z niestandardowym znacznikiem, możesz zmienić jego pozycję za pomocą właściwości labelOrigin w klasie Icon.
text
Typ:  string
Tekst, który ma być wyświetlany na etykiecie.
className optional
Typ:  string optional
Wartość domyślna: '' (pusty ciąg znaków)
Właściwość className elementu etykiety (odpowiednik atrybutu class elementu). Możesz dodać wiele klas CSS rozdzielonych spacjami. Kolor, rozmiar, grubość i rodzinę czcionki można ustawić tylko za pomocą innych właściwości elementu MarkerLabel. Klas CSS nie należy używać do zmiany pozycji ani orientacji etykiety (np. za pomocą translacji i obrotów), jeśli używasz też zarządzania kolizjami znaczników.
color optional
Typ:  string optional
Domyślnie: 'black'
Kolor tekstu etykiety.
fontFamily optional
Typ:  string optional
Rodzina czcionek tekstu etykiety (odpowiednik właściwości font-family w CSS).
fontSize optional
Typ:  string optional
Domyślnie: '14px'
Rozmiar czcionki tekstu etykiety (odpowiednik 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

Interfejs google.maps.MarkerShape

Ten obiekt definiuje obszar obrazu znacznika, który można kliknąć. Kształt składa się z 2 właściwości – type i coord – które definiują nieprzezroczysty obszar obrazu.
type
Typ:  string
Opisuje 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 type i jest zgodny ze specyfikacją w3 AREA coords, którą można znaleźć na stronie http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords.
Atrybut coords to tablica liczb całkowitych, które określają pozycję pikseli kształtu względem lewego górnego rogu obrazu docelowego. Współrzędne 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: coords to [x1,y1,x2,y2...xn,yn], gdzie każda para x,y zawiera współrzędne jednego wierzchołka wielokąta.
  - rect: coords 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 prawego dolnego rogu prostokąta.

Interfejs Symbol

Interfejs google.maps.Symbol

Opisuje symbol, który składa się ze ścieżki wektorowej ze stylem. Symbol może być używany jako ikona znacznika lub umieszczony na linii łamanej.
path
Typ:  SymbolPath|string
Ścieżka symbolu, która jest wbudowaną ścieżką symbolu, lub ścieżka niestandardowa wyrażona 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ą przesuwane w lewo i w górę odpowiednio o współrzędne x i y punktu zakotwiczenia. 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 nazw kolorów. W przypadku znaczników symboli domyślna wartość to „black” (czarny). W przypadku symboli na liniach łamanych domyślnie jest to kolor obrysu odpowiedniej linii łamanej.
fillOpacity optional
Typ:  number optional
Domyślnie: 0
Nieprzezroczystość wypełnienia symbolu.
labelOrigin optional
Typ:  Point optional
Domyślnie: google.maps.Point(0,0)
Punkt początkowy etykiety względem punktu początkowego ścieżki, jeśli etykieta jest dostarczana przez znacznik. Punkt początkowy 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 liniach łamanych.
rotation optional
Typ:  number optional
Domyślnie: 0
Kąt, o który ma zostać obrócony symbol, wyrażony w stopniach zgodnie z ruchem wskazówek zegara. Symbol w elemencie IconSequence, gdzie fixedRotation to false, jest obrócony względem kąta krawędzi, na której się znajduje.
scale optional
Typ:  number optional
Wartość, o którą jest skalowany rozmiar symbolu. W przypadku znaczników symboli domyślna wartość to 1. Po przeskalowaniu symbol może mieć dowolny rozmiar. W przypadku symboli na linii łamanej domyślnie jest to grubość linii łamanej. Po przeskalowaniu symbol musi mieścić się w kwadracie o rozmiarze 22 pikseli wyśrodkowanym na punkcie zakotwiczenia symbolu.
strokeColor optional
Typ:  string optional
Kolor obrysu symbolu. Obsługiwane są wszystkie kolory CSS3 z wyjątkiem rozszerzonych nazw kolorów. W przypadku znaczników symboli domyślna wartość to „black” (czarny). W przypadku symboli na linii łamanej domyślnie jest to kolor obrysu linii łamanej.
strokeOpacity optional
Typ:  number optional
Nieprzezroczystość linii symbolu. W przypadku znaczników symboli domyślna wartość to 1. W przypadku symboli na linii łamanej domyślnie jest to przezroczystość obrysu linii łamanej.
strokeWeight optional
Typ:  number optional
Domyślny: Symbol.scale symbolu.
Grubość konturu symbolu.

Stałe SymbolPath

google.maps.SymbolPath stałe

Wbudowane ścieżki symboli.

Aby uzyskać dostęp, zadzwoń pod numer const {SymbolPath} = await google.maps.importLibrary("core").
Zobacz Biblioteki w 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 Okrąg.
FORWARD_CLOSED_ARROW 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 obiekcie Marker lub opcji MarkerOptions.animation.

Aby uzyskać dostęp, zadzwoń pod numer const {Animation} = await google.maps.importLibrary("marker").
Zobacz Biblioteki w Maps JavaScript API.
BOUNCE Znacznik podskakuje, dopóki animacja nie zostanie zatrzymana przez wywołanie funkcji Marker.setAnimation z parametrem null.
DROP Znacznik spada z góry mapy do ostatecznej lokalizacji. Animacja zostanie zatrzymana, gdy znacznik się zatrzyma, a funkcja Marker.getAnimation zwróci wartość null. Ten typ animacji jest zwykle określany podczas tworzenia znacznika.