Marker

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

zajęcia Marker

google.maps.Marker klasa

Te zajęcia rozciągają się do MVCObject.

Jeśli używasz aplikacji v=beta, możesz zadzwonić pod numer const {Marker} = await google.map.importLibrary("marker"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Marker
Marker([opts])
Parametry:
Tworzy znacznik z określonymi opcjami. Jeśli określisz mapę, podczas jej tworzenia znacznik zostanie dodany do mapy. Pamiętaj, że aby można było wyświetlić znacznik, musi być ustawiona jego pozycja.
getAnimation
getAnimation()
Parametry: brak
Zwrócona wartość: Animation|null|undefined
Pobierz obecnie działającą animację.
getClickable
getClickable()
Parametry: brak
Zwracana wartość: boolean ma wartość Prawda, jeśli znacznik można kliknąć.
Uzyskaj klikalny stan zasobu Marker.
getCursor
getCursor()
Parametry: brak
Zwrócona wartość: string|null|undefined
Wyświetlaj kursor myszy.
getDraggable
getDraggable()
Parametry: brak
Zwracana wartość: boolean ma wartość Prawda, jeśli znacznik można przeciągać.
Sprawdź stan elementu Marker, który można przeciągnąć.
getIcon
getIcon()
Parametry: brak
Zwrócona wartość: string|Icon|null|Symbol|undefined
Pobierz ikonę aplikacji Marker. Zobacz MarkerOptions.icon.
getLabel
getLabel()
Parametry: brak
Zwrócona wartość: MarkerLabel|null|string|undefined
Pobierz etykietę Marker. Zobacz MarkerOptions.label.
getMap
getMap()
Parametry: brak
Zwrócona wartość: Map|StreetViewPanorama
Pobierz mapę lub panoramę, w której wyświetla się 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
Zwrócona wartość: LatLng|null|undefined
Uzyskaj pozycję elementu Marker.
getShape
getShape()
Parametry: brak
Zwrócona wartość: MarkerShape|null|undefined
Uzyskaj kształt elementu Marker używanego do interakcji. Zobacz MarkerOptions.shape oraz MarkerShape.
getTitle
getTitle()
Parametry: brak
Zwrócona wartość: 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.
Sprawdź widoczność reklamy Marker.
getZIndex
getZIndex()
Parametry: brak
Zwracana wartość: number|null|undefined zindeks znacznika.
Pobierz wartość zindex elementu Marker. Zobacz MarkerOptions.zIndex.
setAnimation
setAnimation([animation])
Parametry:
  • animation: Animation optional animacja do odtworzenia.
Zwróć wartość: brak
Uruchom animację. Wszystkie trwające animacje zostaną anulowane. Obecnie obsługiwane animacje: Animation.BOUNCE,Animation.DROP. Przekazanie obiektu null spowoduje zatrzymanie animacji.
setClickable
setClickable(flag)
Parametry:
  • flagboolean Jeśli true ma włączone znacznik, można go kliknąć.
Zwróć wartość: brak
Ustaw, jeśli element Marker można kliknąć.
setCursor
setCursor([cursor])
Parametry:
  • cursor: string optional typ kursora myszy.
Zwróć wartość: brak
Ustaw typ kursora myszy wyświetlany po najechaniu kursorem.
setDraggable
setDraggable(flag)
Parametry:
  • flagboolean optional Jeśli true, znacznik można przeciągnąć.
Zwróć wartość: brak
Ustaw, jeśli element Marker można przeciągać.
setIcon
setIcon([icon])
Parametry:
Zwróć wartość: brak
Ustaw ikonę Marker. Zobacz MarkerOptions.icon.
setLabel
setLabel([label])
Parametry:
Zwróć wartość: brak
Ustaw etykietę elementu Marker. Zobacz MarkerOptions.label.
setMap
setMap(map)
Parametry:
Zwróć wartość: brak
Renderuje zasadę Marker na określonej mapie lub w panoramicznym obrazie. Jeśli mapa ma wartość null, znacznik zostanie usunięty.
setOpacity
setOpacity([opacity])
Parametry:
  • opacity: number optional liczba z zakresu od 0,0 przezroczysta do 1,0 nieprzejrzysta.
Zwróć wartość: brak
Ustaw przezroczystość elementu Marker.
setOptions
setOptions(options)
Parametry:
Zwróć wartość: brak
Ustaw opcje dla zasobu Marker.
setPosition
setPosition([latlng])
Parametry:
Zwróć wartość: brak
Ustaw element Marker.
setShape
setShape([shape])
Parametry:
Zwróć wartość: brak
Ustaw kształt elementu Marker używanego do interakcji. Zobacz MarkerOptions.shape oraz MarkerShape.
setTitle
setTitle([title])
Parametry:
  • titlestring optional
Zwróć wartość: brak
Ustaw tytuł etykietki Marker. Zobacz MarkerOptions.title.
setVisible
setVisible(visible)
Parametry:
  • visibleboolean Jeśli etykieta true jest widoczna,
Zwróć wartość: brak
Ustaw, jeśli element Marker jest widoczny.
setZIndex
setZIndex([zIndex])
Parametry:
  • zIndexnumber optional
Zwróć wartość: brak
Ustaw wartość zindex elementu Marker. Zobacz MarkerOptions.zIndex.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
MAX_ZINDEX Maksymalny domyślny Z-index, jaki interfejs API przypisze do znacznika. Możesz ustawić wyższy stopień nakładania elementów, by przesunąć znacznik z przodu.
animation_changed
function()
Argumenty: brak
To zdarzenie jest uruchamiane po zmianie właściwości animacji Marker.
click
function(event)
Argumenty:
To zdarzenie jest uruchamiane po kliknięciu ikony Marker.
clickable_changed
function()
Argumenty: brak
To zdarzenie jest uruchamiane 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 uruchamiane Marker
cursor_changed
function()
Argumenty: brak
To zdarzenie jest uruchamiane 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ąga element Marker.
dragend
function(event)
Argumenty:
Zdarzenie jest uruchamiane, gdy użytkownik przestanie przeciągać element Marker.
draggable_changed
function()
Argumenty: brak
To zdarzenie jest uruchamiane po zmianie właściwości Marker, którą można przeciągać.
dragstart
function(event)
Argumenty:
Zdarzenie jest uruchamiane, gdy użytkownik rozpocznie przeciąganie: Marker.
flat_changed
function()
Argumenty: brak
To zdarzenie jest uruchamiane po zmianie płaskiej usługi Marker.
icon_changed
function()
Argumenty: brak
To zdarzenie jest uruchamiane po zmianie właściwości ikony Marker.
mousedown
function(event)
Argumenty:
To zdarzenie jest uruchamiane w celu najechania kursorem myszy na element Marker.
mouseout
function(event)
Argumenty:
Zdarzenie jest uruchamiane, gdy kursor myszy opuści obszar ikony Marker.
mouseover
function(event)
Argumenty:
Zdarzenie to jest uruchamiane, gdy kursor myszy znajduje się w obszarze ikony Marker.
mouseup
function(event)
Argumenty:
To zdarzenie jest uruchamiane w celu uruchomienia kursora myszy na urządzeniu Marker.
position_changed
function()
Argumenty: brak
To zdarzenie jest uruchamiane po zmianie właściwości pozycji Marker.
shape_changed
function()
Argumenty: brak
To zdarzenie jest uruchamiane po zmianie właściwości kształtu Marker.
title_changed
function()
Argumenty: brak
To zdarzenie jest uruchamiane, gdy zmieni się właściwość 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 uruchamiane po zmianie właściwości Marker Zindex.
rightclick
function(event)
Argumenty:
To zdarzenie jest uruchamiane po kliknięciu prawym przyciskiem myszy w Marker.

Interfejs MarkerOptions

google.maps.MarkerOptions interfejs

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 kotwica.
animation optional
Typ: Animation optional
Domyślne: null
Animacja odtwarzana po dodaniu znacznika na mapie.
clickable optional
Typ: boolean optional
Domyślne: true
Jeśli true, znacznik odbiera zdarzenia myszy i dotyku.
BetacollisionBehavior optional
Typ: string|CollisionBehavior optional
Domyślne: null
Ustaw sposób kolizji w przypadku znaczników na mapach wektorowych.
crossOnDrag optional
Typ: boolean optional
Domyślne: true
Jeśli false, podczas przeciągania wyłącza krzyżyk widoczny pod znacznikiem.
cursor optional
Typ: string optional
Domyślne: pointer
Typ kursora myszy, który jest wyświetlany po najechaniu kursorem.
draggable optional
Typ: boolean optional
Domyślne: false
Jeśli true, znacznik można przeciągnąć.
icon optional
Typ: string|Icon|Symbol optional
Ikona pierwszego planu. Jeśli zostanie podany ciąg tekstowy, będzie on traktowany jak ciąg znaków 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 liczba pojawiająca się w znaczniku. Etykieta może być ciągiem znaków lub obiektem MarkerLabel. Jeśli nie zostanie podany tag MarkerOptions.title, nie zostanie podany tekst ułatwień dostępu (np. dla czytników ekranu) z tekstem dostarczonej etykiety. Pamiętaj, że 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. Do wyświetlenia znacznika wymagana jest mapa. Jeśli nie podasz konstrukcji znacznika, możesz ją udostępnić w Marker.setMap.
opacity optional
Typ: number optional
Domyślna: 1.0
Liczba z zakresu od 0,0 przezroczysta do 1,0 nieprzezroczysta.
optimized optional
Typ: boolean optional
Optymalizacja zwiększa skuteczność, ponieważ renderuje wiele znaczników jako jeden element statyczny. Jest to przydatne w przypadkach, 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 być konstruowany, ale nie może być wyświetlany, dopóki nie zostanie podany jego położenie – na przykład przez działania lub wybory użytkownika. Położenie znacznika można podać dla atrybutu Marker.setPosition, jeśli nie został podany w budowie znaczników.
shape optional
Typ: MarkerShape optional
Definicja regionu mapy obrazu używana w przypadku przeciągania i klikania.
title optional
Typ: string optional
Domyślne: undefined
Tekst po najechaniu kursorem. Jeśli zostanie podany, do znacznika z podaną wartością zostanie dodany tekst ułatwień dostępu (np. do użytku z czytnikami ekranu). Pamiętaj, że 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 nakładania się elementów, a wyższe wartości są wyświetlane przed znacznikami o niższych wartościach. Domyślnie znaczniki są wyświetlane na podstawie pozycji w pionie, a niższe znaczniki są wyświetlane przed znacznikami w górnej części ekranu.

Stałe koligacji

google.maps.CollisionBehavior stałe

Jeśli używasz aplikacji v=beta, możesz zadzwonić pod numer const {CollisionBehavior} = await google.map.importLibrary("marker"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

OPTIONAL_AND_HIDES_LOWER_PRIORITY Wyświetlaj znacznik tylko wtedy, gdy nie nakłada się on z innymi znacznikami. Jeśli dwa znaczniki tego typu będą się nakładać, wyświetli się ten o wyższym indeksie. Jeśli mają taki sam parametr zIndex, wyświetli się ten z niższą pionową pozycją ekranu.
REQUIRED Zawsze wyświetlaj znacznik niezależnie od kolizji. Jest to zachowanie domyślne.
REQUIRED_AND_HIDES_OPTIONAL Zawsze wyświetlaj znacznik niezależnie od kolizji i ukryj wszelkie znaczniki lub etykiety OPTIONAL_AND_HIDES_LOWER_PRIORITY, które będą się nakładać na znacznik.

Interfejs ikony

google.maps.Icon interfejs

Struktura przedstawiająca obraz ikony 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 związku z lokalizacją znacznika na mapie. Reklama zakotwiczona znajduje się domyślnie wzdłuż punktu środkowego u dołu obrazu.
labelOrigin optional
Typ: Point optional
Punkt początkowy etykiety względem lewego górnego rogu obrazu ikony, jeśli została ona podana przez znacznik. Domyślnie źródło znajduje się w środkowym punkcie obrazu.
origin optional
Typ: Point optional
Pozycja obrazu w usłudze sprite. Punkt początkowy domyślnie znajduje się w lewym górnym rogu obrazu (0, 0).
scaledSize optional
Typ: Size optional
Rozmiar całego obrazu po skalowaniu (jeśli istnieje). Użyj tej właściwości, aby rozciągnąć lub zwinąć obraz lub duszek.
size optional
Typ: Size optional
Rozmiar wyświetlania sprite'a 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 znak), który pojawia się 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świetlenia w etykiecie.
className optional
Typ: string optional
Domyślny: '' (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, wagę i rodzinę czcionki możesz ustawić tylko za pomocą innych właściwości właściwości MarkerLabel. Klasy CSS nie powinny służyć do zmiany pozycji ani orientacji etykiety (np. przy użyciu tłumaczeń czy obrotu), jeśli są też używane zarządzanie 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 – waga czcionki).

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 obszar obrazu.

coords
Typ: Array<number>
Format tego atrybutu zależy od wartości atrybutu type i jest zgodny ze specyfikacją obszaru (w3) coords (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 parametru type:
circle: współrzędne to [x1,y1,r], gdzie x1,y2 to współrzędne środka koła, a r jest promieniem okręgu.
poly: współrzędne to [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 współrzędnych w prawym dolnym rogu.
type
Typ: string
Opisuje typ kształtu i może mieć wartość circle, poly lub rect.

Symbol interfejs

google.maps.Symbol interfejs

Opisuje symbol, który składa się ze ścieżki wektorowej ze stylem. Symbolu można użyć jako ikony znacznika lub umieścić na linii łamanej.

path
Typ: SymbolPath|string
Ścieżka symbolu, która jest wbudowana ścieżką symbolu lub ścieżka niestandardowa wyrażona w notacji ścieżki SVG. Wymagany.
anchor optional
Typ: Point optional
Domyślne: google.maps.Point(0,0)
Pozycja symbolu względem 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 układzie współrzędnych co ścieżka symbolu.
fillColor optional
Typ: string optional
Kolor wypełnienia symbolu. Obsługiwane są wszystkie kolory CSS3 oprócz rozszerzonych nazw kolorów. W przypadku znaczników symboli domyślnie jest to „czarny”. W przypadku symboli na linii łamanych domyślnie jest to 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)
Punkt początkowy etykiety względem punktu początkowego ścieżki, jeśli etykieta została podana przez znacznik. Punkt początkowy jest wyrażony w tym samym systemie współrzędnych, co ścieżka symbolu. Ta właściwość nie jest używana w przypadku symboli na 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 kolumnie IconSequence, w której fixedRotation to false, jest obrócony względem kąta krawędzi, na której się on znajduje.
scale optional
Typ: number optional
Kwota, o jaką symbol jest skalowany. W przypadku znaczników symboli domyślna wartość to 1. Po skalowaniu symbol może mieć dowolny rozmiar. W przypadku symboli na linii łamającej jest to domyślna waga linii łamanej. Po skalowaniu symbol musi znajdować się w kwadratowym rozmiarze 22 pikseli, wyśrodkowanym na zakotwiczeniu symbolu.
strokeColor optional
Typ: string optional
Kolor kreski symbolu. Obsługiwane są wszystkie kolory CSS3 oprócz rozszerzonych nazw kolorów. W przypadku znaczników symboli domyślnie jest to „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ślna wartość to 1. W przypadku symboli na linii łamającej jest to domyślne ustawienie krycia linii linii łamanej.
strokeWeight optional
Typ: number optional
Domyślny: znak Symbol.scale.
Waga kreski kreski

Stałe SymbolPath

google.maps.SymbolPath stałe

Wbudowane ścieżki symboli.

Jeśli używasz aplikacji v=beta, możesz zadzwonić pod numer const {SymbolPath} = await google.map.importLibrary("core"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

BACKWARD_CLOSED_ARROW Strzałka w lewo skierowana do tyłu.
BACKWARD_OPEN_ARROW Strzałka otwierająca do tyłu.
CIRCLE Kółko.
FORWARD_CLOSED_ARROW Strzałka zamknięta w przód.
FORWARD_OPEN_ARROW Strzałka otwarta do przodu.

Stałe animacyjne

google.maps.Animation stałe

Animacje, które można odtwarzać na znaczniku. Aby odtworzyć animację, użyj znacznika Marker.setAnimation lub znacznika MarkerOptions.animation.

Jeśli używasz aplikacji v=beta, możesz zadzwonić pod numer const {Animation} = await google.map.importLibrary("marker"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

BOUNCE Znacznik skacze do momentu zatrzymania animacji, wywołując Marker.setAnimation przy użyciu null.
DROP Znacznik jest usuwany z góry mapy do ostatecznej lokalizacji. Animacja zakończy się, gdy znacznik znajdzie się w spoczynku, a Marker.getAnimation zwróci null. Ten typ animacji jest zwykle określany podczas tworzenia znacznika.