Marker (legacy)

Zajęcia Marker

google.maps.Marker zajęcia

Te zajęcia są rozszerzone na MVCObject.

Aby uzyskać dostęp, zadzwoń 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 podczas budowy. Pamiętaj, że aby znacznik się wyświetlał, musi być ustawiona pozycja.
MAX_ZINDEX Maksymalna domyślna kolejność nakładania elementów, jaką interfejs API przypisze do znacznika. Możesz ustawić większą kolejność nakładania elementów, aby znacznik znalazł się na wierzchu.
getAnimation
getAnimation()
Parametry: brak
Wartość zwrotu:  Animation|null|undefined
Pobierz aktualnie uruchomioną animację.
getClickable
getClickable()
Parametry: brak
Zwracana wartość:  boolean Prawda, jeśli znacznik można kliknąć.
Sprawdź stan przycisku Marker, który można kliknąć.
getCursor
getCursor()
Parametry: brak
Wartość zwrotu:  string|null|undefined
Ustaw typ kursora myszy widoczny po najechaniu.
getDraggable
getDraggable()
Parametry: brak
Zwracana wartość:  boolean Prawda, jeśli znacznik można przeciągać.
Pobierz stan elementu Marker, który można przeciągnąć.
getIcon
getIcon()
Parametry: brak
Wartość zwrotu:  string|Icon|Symbol|null|undefined
Pobierz ikonę aplikacji 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ę, w której jest renderowany Marker.
getOpacity
getOpacity()
Parametry: brak
Zwracana wartość:  number|null|undefined liczba od 0,0 do 1,0.
Uzyskuj przezroczystość: Marker.
getPosition
getPosition()
Parametry: brak
Wartość zwrotu:  LatLng|null|undefined
Sprawdź pozycję Marker.
getShape
getShape()
Parametry: brak
Wartość zwrotu:  MarkerShape|null|undefined
Uzyskaj kształt elementu Marker używanego do interakcji. Zobacz MarkerOptions.shape i MarkerShape.
getTitle
getTitle()
Parametry: brak
Wartość zwrotu:  string|null|undefined
Uzyskaj tytuł etykietki Marker. Zobacz MarkerOptions.title.
getVisible
getVisible()
Parametry: brak
Zwracana wartość:  boolean Prawda, jeśli znacznik jest widoczny.
Zobacz: Marker.
getZIndex
getZIndex()
Parametry: brak
Zwracana wartość:  number|null|undefined zIndex znacznika.
Zobacz dla indeksu zIndex Marker. Zobacz MarkerOptions.zIndex.
setAnimation
setAnimation([animation])
Parametry: 
  • animation:  Animation optional animacja do odtworzenia.
Zwracana wartość: brak
Rozpocznij animację. Wszystkie trwające animacje zostaną anulowane. Obecnie obsługiwane animacje to: Animation.BOUNCE, Animation.DROP. Przekazanie parametru null spowoduje zatrzymanie animacji.
setClickable
setClickable(flag)
Parametry: 
  • flag:  boolean Jeśli true, można kliknąć Znacznik.
Zwracana wartość: brak
Określa, czy Marker można kliknąć.
setCursor
setCursor([cursor])
Parametry: 
  • cursor:  string optional typ kursora myszy.
Zwracana wartość: brak
Ustaw typ kursora wyświetlanego po najechaniu.
setDraggable
setDraggable(flag)
Parametry: 
  • flag:  boolean optional Jeśli true, można przeciągnąć znacznik.
Zwracana wartość: brak
Ustaw, jeśli 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ę Marker. Zobacz MarkerOptions.label.
setMap
setMap(map)
Parametry: 
Zwracana wartość: brak
Renderuje obiekt 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, przezroczysta do 1, 0 (nieprzezroczysta).
Zwracana wartość: brak
Ustaw przezroczystość elementu Marker.
setOptions
setOptions(options)
Parametry: 
Zwracana wartość: brak
Ustaw opcje dla interfejsu Marker.
setPosition
setPosition([latlng])
Parametry: 
Zwracana wartość: brak
Ustaw posta dla: Marker.
setShape
setShape([shape])
Parametry: 
Zwracana wartość: brak
Ustaw kształt elementu Marker używanego do interakcji. Zobacz MarkerOptions.shape i 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
Ustaw, jeśli Marker jest widoczny.
setZIndex
setZIndex([zIndex])
Parametry: 
  • zIndex:  number optional
Zwracana wartość: brak
Ustaw wartość zIndex dla indeksu Marker. Zobacz MarkerOptions.zIndex.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
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
Zdarzenie jest uruchamiane w momencie zmiany 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: 
Zdarzenie to jest wywoływane po dwukrotnym kliknięciu ikony Marker.
drag
function(event)
Argumenty: 
To zdarzenie jest uruchamiane wielokrotnie, gdy użytkownik przeciąga Marker.
dragend
function(event)
Argumenty: 
Zdarzenie to 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ść przeciągania Marker.
dragstart
function(event)
Argumenty: 
Zdarzenie to jest wywoływane, gdy użytkownik zaczyna przeciągać element Marker.
flat_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości 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: 
Zdarzenie jest wywoływane, gdy kursor myszy opuści obszar ikony Marker.
mouseover
function(event)
Argumenty: 
Zdarzenie jest uruchamiane, 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 uruchamiane po zmianie widocznej właściwości Marker.
zindex_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości zIndex Marker.
rightclick
function(event)
Argumenty: 
Zdarzenie to jest wywoływane po kliknięciu prawym przyciskiem myszy elementu Marker.

Interfejs MarkerOptions

google.maps.MarkerOptions interfejs

Obiekt MarkOptions służący do definiowania właściwości, które można ustawić w znacznikach.
anchorPoint optional
Typ:  Point optional
Przesunięcie od położenia znacznika do końca okna informacyjnego, które zostało otwarte ze znacznikiem jako kotwicą.
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 odbiera zdarzenia myszy i dotknięcia.
BetacollisionBehavior optional
Typ:  string|CollisionBehavior optional
Wartość domyślna: null
Określ sposób kolizji znaczników na mapach wektorowych.
crossOnDrag optional
Typ:  boolean optional
Wartość domyślna: true
Przy ustawieniu false wyłącza krzyżyk, który podczas przeciągania będzie widoczny pod znacznikiem.
cursor optional
Typ:  string optional
Wartość domyślna: pointer
Typ kursora myszy, który ma być 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 Icon z ciągiem znaków url.
label optional
Typ:  string|MarkerLabel optional
Wartość domyślna: null
Dodaje etykietę do znacznika. Etykieta znacznika to litera lub cyfra wewnątrz znacznika. Etykieta może być ciągiem znaków lub obiektem MarkerLabel. Jeśli zostanie podany, a atrybut MarkerOptions.title nie zostanie podany, do znacznika zostanie dodany tekst ułatwień dostępu (np. przeznaczony do czytników ekranu) z tym tekstem. Pamiętaj, że label jest obecnie używany tylko w tekście ułatwień dostępu dla niezoptymalizowanych znaczników.
map optional
Typ:  Map|StreetViewPanorama optional
Mapa, na której ma być wyświetlany znacznik. Do wyświetlenia znacznika wymagana jest mapa. Jeśli jej nie podano podczas budowy znacznika, można ją otrzymać z wartością Marker.setMap.
opacity optional
Typ:  number optional
Wartość domyślna:1,0
Liczba z zakresu od 0,0 (przezroczysta) do 1,0 (nieprzezroczysta).
optimized optional
Typ:  boolean optional
Optymalizacja zwiększa skuteczność przez renderowanie wielu znaczników jako jednego elementu statycznego. 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
Ustawia pozycję znacznika. Znacznik może zostać utworzony, ale nie będzie wyświetlany, dopóki nie zostanie określona jego pozycja (na przykład w wyniku działań lub wyborów użytkownika). Jeśli przy budowie znacznika nie podano położenia znacznika, można podać wartość 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 wyświetlany po najechaniu kursorem myszy. 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 title jest obecnie używany tylko w tekście ułatwień dostępu dla 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 według ich zIndex – wyższe wartości są wyświetlane przed tymi o niższych wartościach. Domyślnie znaczniki są wyświetlane na ekranie zgodnie z ich umiejscowieniem w pionie. Dolne znaczniki znajdują się przed znacznikami w górnej części ekranu.

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 interfejsie Maps JavaScript API.
OPTIONAL_AND_HIDES_LOWER_PRIORITY Wyświetl 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 wskaźniku ZIndex. Jeśli mają jednakową wartość zIndex, wyświetlana jest strona z niższą pozycją na ekranie w pionie.
REQUIRED Zawsze wyświetlaj znacznik niezależnie od zderzeń. Jest to jego ustawienie domyślne.
REQUIRED_AND_HIDES_OPTIONAL Znacznik jest zawsze wyświetlany niezależnie od kolizji i ukrywa wszystkie znaczniki OPTIONAL_AND_HIDES_LOWER_PRIORITY lub etykiety, które mogłyby się z nimi nakładać.

Interfejs ikony

google.maps.Icon interfejs

Struktura reprezentująca obraz ikony znacznika.
url
Typ:  string
Adres URL obrazu lub arkusza sprite.
anchor optional
Typ:  Point optional
Pozycja, w której ma zostać zakotwiczony obraz odpowiadający lokalizacji znacznika na mapie. Domyślnie kotwica znajduje się w środkowym punkcie 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 punkcie środkowym zdjęcia.
origin optional
Typ:  Point optional
Pozycja obrazu w obrębie 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 występuje). 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 podany, zostanie on ustawiony po wczytaniu 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 znacznika niestandardowego, możesz zmienić jego położenie za pomocą właściwości labelOrigin w klasie Icon.
text
Typ:  string
Tekst, który ma być wyświetlany w etykiecie.
className optional
Typ:  string optional
Wartość domyślna: '' (pusty ciąg znaków)
Właściwość className elementu etykiety (odpowiednik atrybutu klasy 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 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 translacji i obrót).
color optional
Typ:  string optional
Wartość domyślna: 'black'
Kolor tekstu etykiety.
fontFamily optional
Typ:  string optional
Rodzina czcionek tekstu etykiety (odpowiednika właściwości CSS font-family).
fontSize optional
Typ:  string optional
Wartość domyślna: '14px'
Rozmiar czcionki tekstu etykiety (odpowiednik właściwości CSS font-size).
fontWeight optional
Typ:  string optional
Grubość czcionki tekstu etykiety (odpowiednik właściwości CSS font-weight).

Interfejs MarkerShape

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 AREA 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 piksela kształtu względem lewego górnego rogu obrazu docelowego. Współrzędne zależą od wartości type w taki 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: 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 przyjmować wartości 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 służyć 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ę zgodnie ze współrzędnymi 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. W przypadku znaczników symboli ta wartość domyślna to „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 wyrażany 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 element fixedRotation ma wartość false, jest obrócony względem kąta krawędzi, na którym się leży.
scale optional
Typ:  number optional
Wielkość, o jaką skalowany jest rozmiar symbolu. 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ślna wartość to grubość konturu linii łamanej. Po przeskalowaniu symbol musi znajdować się wewnątrz kwadratu o wymiarach 22 pikseli wyśrodkowanych na punkcie zakotwiczenia symbolu.
strokeColor optional
Typ:  string optional
Kolor kreski symbolu. Obsługiwane są wszystkie kolory CSS3 z wyjątkiem rozszerzonych kolorów. W przypadku znaczników symboli ta wartość domyślna to „czarny”. W przypadku symboli na linii łamanej domyślnym kolorem jest linia łamana.
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ślna wartość to przezroczystość kreski linii łamanej.
strokeWeight optional
Typ:  number optional
Wartość domyślna: Symbol.scale symbolu.
Grubość konturu symboli.

SymbolPath stałe

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 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 Koło.
FORWARD_CLOSED_ARROW Zamknięta strzałka skierowana do przodu.
FORWARD_OPEN_ARROW Otwarta strzałka skierowana do przodu.

Stałe animacje

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.

Aby uzyskać dostęp, zadzwoń pod numer const {Animation} = await google.maps.importLibrary("marker"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
BOUNCE Znacznik będzie skakał do momentu zatrzymania animacji przez wywołanie Marker.setAnimation o funkcji null.
DROP Znacznik przesunie się z góry mapy do ostatecznego położenia. Animacja zostanie zatrzymana, gdy znacznik zatrzyma się, a Marker.getAnimation zwróci wartość null. Ten typ animacji jest zwykle określany podczas tworzenia znacznika.