Data

Dane klasy

google.maps.Data zajęcia

Warstwa do wyświetlania danych geoprzestrzennych. Możesz wyświetlać punkty, linie i wielokąty.

Każdy element Map ma domyślnie obiekt Data, więc w większości przypadków nie trzeba go tworzyć. Na przykład:

 var myMap = new google.maps.Map(...);
myMap.data.addGeoJson(...);
myMap.data.setStyle(...);
 Obiekt Data to zbiór Features.

Ta klasa rozszerza klasę MVCObject.

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

Data
Data([options])
Parametry: 
Tworzy pustą kolekcję z podanym parametrem DataOptions.
add
add([feature])
Parametry: 
Zwracana wartość:  Data.Feature
Dodaje do kolekcji obiekt i zwraca dodany obiekt.

Jeśli cecha ma identyfikator, zastąpi on każdą istniejącą cechę w kolekcji o tym samym identyfikatorze. Jeśli nie podasz żadnej funkcji, utworzymy nową funkcję z geometrią o wartości null i bez właściwości. Jeśli podasz FeatureOptions, utworzymy nową funkcję z określonymi właściwościami.

Pamiętaj, że identyfikatory 1234'1234' są równoważne. Dodanie funkcji o identyfikatorze 1234 spowoduje zastąpienie funkcji o identyfikatorze '1234' i odwrotnie.

addGeoJson
addGeoJson(geoJson[, options])
Parametry: 
Zwracana wartość:  Array<Data.Feature>
Dodaje do kolekcji obiekty GeoJSON. Przekaż do tej metody przeanalizowany kod JSON. Zwrócone zostaną zaimportowane cechy. Zwraca wyjątek, jeśli nie udało się zaimportować pliku GeoJSON.
contains
contains(feature)
Parametry: 
Zwracana wartość:  boolean
Sprawdza, czy dana funkcja znajduje się w kolekcji.
forEach
forEach(callback)
Parametry: 
Zwracana wartość: brak
Wielokrotnie wywołuje podaną funkcję, przekazując do niej cechę z kolekcji przy każdym wywołaniu. Kolejność iteracji przez funkcje jest nieokreślona.
getControlPosition
getControlPosition()
Parametry: brak
Zwracana wartość:  ControlPosition
Zwraca pozycję elementów sterujących rysowaniem na mapie.
getControls
getControls()
Parametry: brak
Zwracana wartość:  Array<string>
Zwraca tryby rysowania dostępne dla użytkownika w kolejności, w jakiej są wyświetlane. Nie obejmuje to trybu rysowania null, który jest dodawany domyślnie. Możliwe tryby rysowania to "Point", "LineString" lub "Polygon".
getDrawingMode
getDrawingMode()
Parametry: brak
Zwracana wartość:  string|null
Zwraca bieżący tryb rysowania danej warstwy danych. Tryb rysowania null oznacza, że użytkownik może normalnie korzystać z mapy, a kliknięcia nie powodują rysowania. Możliwe tryby rysowania to null, "Point", "LineString" lub "Polygon".
getFeatureById
getFeatureById(id)
Parametry: 
  • idnumber|string
Zwracana wartość:  Data.Feature|undefined
Zwraca element o podanym identyfikatorze, jeśli znajduje się w kolekcji. W przeciwnym razie zwraca wartość undefined.

Pamiętaj, że identyfikatory 1234'1234' są równoważne. Oba te sposoby pozwalają wyszukać tę samą funkcję.

getMap
getMap()
Parametry: brak
Zwracana wartość:  Map
Zwraca mapę, na której wyświetlane są obiekty.
getStyle
getStyle()
Parametry: brak
Pobiera styl wszystkich obiektów w kolekcji.
loadGeoJson
loadGeoJson(url[, options, callback])
Parametry: 
Zwracana wartość: brak
Wczytuje GeoJSON z adresu URL i dodaje funkcje do kolekcji.

UWAGA: plik GeoJSON jest pobierany za pomocą XHR i może nie działać w przypadku różnych domen. Jeśli masz problemy, zalecamy pobranie GeoJSON za pomocą wybranej biblioteki AJAX, a następnie wywołanie funkcji addGeoJson().

overrideStyle
overrideStyle(feature, style)
Parametry: 
Zwracana wartość: brak
Zmienia styl elementu. Te zmiany są stosowane na podstawie stylu określonego przez setStyle(). Właściwości stylu ustawione na null wracają do wartości określonej za pomocą setStyle().
remove
remove(feature)
Parametry: 
Zwracana wartość: brak
Usuwa funkcję z kolekcji.
revertStyle
revertStyle([feature])
Parametry: 
Zwracana wartość: brak
Usuwa efekt poprzednich połączeń overrideStyle(). Styl danej funkcji zostanie przywrócony do stylu określonego przez setStyle().

Jeśli nie podasz żadnej funkcji, styl wszystkich funkcji zostanie przywrócony.

setControlPosition
setControlPosition(controlPosition)
Parametry: 
Zwracana wartość: brak
Określa położenie elementów sterujących rysowaniem na mapie.
setControls
setControls(controls)
Parametry: 
  • controlsArray<string>
Zwracana wartość: brak
Określa, które tryby rysowania są dostępne dla użytkownika, w kolejności, w jakiej są wyświetlane. Nie powinna ona obejmować trybu rysowania null, który jest dodawany domyślnie. Jeśli null, elementy sterujące rysowaniem są wyłączone i niewidoczne. Możliwe tryby rysowania to "Point", "LineString" lub "Polygon".
setDrawingMode
setDrawingMode(drawingMode)
Parametry: 
  • drawingModestring optional
Zwracana wartość: brak
Ustawia bieżący tryb rysowania dla danej warstwy danych. Tryb rysowania null oznacza, że użytkownik może normalnie korzystać z mapy, a kliknięcia nie powodują rysowania. Możliwe tryby rysowania to null, "Point", "LineString" lub "Polygon".
setMap
setMap(map)
Parametry: 
Zwracana wartość: brak
Renderuje elementy na określonej mapie. Jeśli mapa jest ustawiona na null, obiekty zostaną z niej usunięte.
setStyle
setStyle(style)
Zwracana wartość: brak
Ustawia styl wszystkich obiektów w kolekcji. Style określone dla poszczególnych funkcji za pomocą parametru overrideStyle() nadal obowiązują.

Przekaż obiekt z odpowiednimi opcjami stylu lub funkcję, która oblicza styl dla każdej funkcji. Funkcja będzie wywoływana za każdym razem, gdy właściwości funkcji zostaną zaktualizowane.

toGeoJson
toGeoJson(callback)
Parametry: 
  • callbackfunction(Object): void
Zwracana wartość: brak
Eksportuje obiekty w kolekcji do obiektu GeoJSON.
Odziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
addfeature
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy do kolekcji zostanie dodana funkcja.
click
function(event)
Argumenty: 
To zdarzenie jest wywoływane po kliknięciu geometrii.
contextmenu
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy w geometrii zostanie wywołane zdarzenie DOM contextmenu.
dblclick
function(event)
Argumenty: 
To zdarzenie jest wywoływane po dwukrotnym kliknięciu geometrii.
mousedown
function(event)
Argumenty: 
To zdarzenie jest wywoływane po naciśnięciu przycisku myszy na geometrii.
mouseout
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy wskaźnik myszy opuści obszar geometrii.
mouseover
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy kursor myszy wjedzie w obszar geometrii.
mouseup
function(event)
Argumenty: 
To zdarzenie jest wywoływane po zwolnieniu przycisku myszy na geometrii.
removefeature
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy funkcja zostanie usunięta z kolekcji.
removeproperty
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy właściwość funkcji zostanie usunięta.
setgeometry
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy ustawiona jest geometria obiektu.
setproperty
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy ustawiona jest właściwość funkcji.
rightclick
function(event)
Argumenty: 
To zdarzenie jest wywoływane po kliknięciu geometrii prawym przyciskiem myszy.

Data.DataOptions interfejs

google.maps.Data.DataOptionsinterfejs

Obiekt DataOptions służący do definiowania właściwości, które deweloper może ustawić w obiekcie Data.

map
Typ:  Map
Mapa, na której mają być wyświetlane obiekty w kolekcji.
controlPosition optional
Typ:  ControlPosition optional
Położenie elementów sterujących rysowaniem na mapie.
controls optional
Typ:  Array<string> optional
Domyślnie: null
Opisuje, które tryby rysowania są dostępne dla użytkownika, w kolejności, w jakiej są wyświetlane. Nie powinna ona obejmować trybu rysowania null, który jest dodawany domyślnie. Jeśli null, elementy sterujące rysowaniem są wyłączone i niewidoczne. Możliwe tryby rysowania to "Point", "LineString" lub "Polygon".
drawingMode optional
Typ:  string optional
Domyślnie: null
Bieżący tryb rysowania danej warstwy danych. Tryb rysowania null oznacza, że użytkownik może normalnie korzystać z mapy, a kliknięcia nie powodują rysowania. Możliwe tryby rysowania to null, "Point", "LineString" lub "Polygon".
featureFactory optional
Typ:  function(Data.Geometry): Data.Feature optional
Gdy rysowanie jest włączone, a użytkownik narysuje geometrię (punkt, linię lub wielokąt), ta funkcja jest wywoływana z tą geometrią i powinna zwracać obiekt, który ma zostać dodany do warstwy danych. Jeśli nie podasz funkcji featureFactory, z obiektu Geometry zostanie utworzony obiekt Feature bez identyfikatora i właściwości. Domyślna wartość to null.
style optional
Styl dla wszystkich obiektów w kolekcji. Więcej informacji znajdziesz w sekcji setStyle() powyżej.

Data.GeoJsonOptions interface

google.maps.Data.GeoJsonOptionsinterfejs

Opcjonalne parametry importowania GeoJSON.

idPropertyName optional
Typ:  string optional
Nazwa właściwości obiektu, która ma być używana jako identyfikator obiektu. Jeśli nie zostanie podany, użyty zostanie identyfikator obiektu GeoJSON.

Data.StyleOptions interfejs

google.maps.Data.StyleOptionsinterfejs

Te opcje określają sposób wyświetlania obiektu na mapie.

animation optional
Typ:  Animation optional
Animacja, która ma być odtwarzana po dodaniu znacznika do mapy. Dotyczy tylko geometrii punktowych.