Data

Data class

google.maps.Data classe

Un livello per la visualizzazione dei dati geospaziali. È possibile visualizzare punti, stringhe di linee e poligoni.

Ogni Map ha un oggetto Data per impostazione predefinita, quindi la maggior parte delle volte non è necessario costruirne uno. Ad esempio: 

 var myMap = new google.maps.Map(...);
 myMap.data.addGeoJson(...);
 myMap.data.setStyle(...);
L'oggetto Data è una raccolta di Features.

Questo corso si estende MVCObject.

Accesso chiamando il numero const {Data} = await google.maps.importLibrary("maps").
Consulta Librerie nell'API Maps JavaScript.
Data
Data([options])
Parametri: 
Crea una raccolta vuota con il DataOptions specificato.
add
add([feature])
Parametri: 
Valore restituito:  Data.Feature
Aggiunge una funzionalità alla raccolta e restituisce la funzionalità aggiunta.

Se la funzionalità ha un ID, sostituirà qualsiasi funzionalità esistente nella raccolta con lo stesso ID. Se non viene fornita alcuna funzionalità, ne verrà creata una nuova con geometria nulla e nessuna proprietà. Se vengono forniti FeatureOptions, verrà creata una nuova funzionalità con le proprietà specificate.

Tieni presente che gli ID 1234 e '1234' sono equivalenti. L'aggiunta di una funzionalità con ID 1234 sostituirà una funzionalità con ID '1234' e viceversa.
addGeoJson
addGeoJson(geoJson[, options])
Parametri: 
Valore restituito:  Array<Data.Feature>
Aggiunge funzionalità GeoJSON alla raccolta. Fornisci a questo metodo un JSON analizzato. Vengono restituite le caratteristiche importate. Genera un'eccezione se non è possibile importare il GeoJSON.
contains
contains(feature)
Parametri: 
Valore restituito:  boolean
Controlla se la funzionalità specificata è presente nella raccolta.
forEach
forEach(callback)
Parametri: 
Valore restituito:nessuno
Invoca ripetutamente la funzione specificata, passando una funzionalità nella raccolta alla funzione a ogni invocazione. L'ordine di iterazione tra le funzionalità non è definito.
getControlPosition
getControlPosition()
Parametri: nessuno
Valore restituito:  ControlPosition
Restituisce la posizione dei controlli di disegno sulla mappa.
getControls
getControls()
Parametri: nessuno
Valore restituito:  Array<string>
Restituisce le modalità di disegno disponibili per la selezione da parte dell'utente, nell'ordine in cui vengono visualizzate. Non include la modalità di disegno null, che viene aggiunta per impostazione predefinita. Le modalità di disegno possibili sono "Point", "LineString" o "Polygon".
getDrawingMode
getDrawingMode()
Parametri: nessuno
Valore restituito:  string|null
Restituisce la modalità di disegno corrente del livello dati specificato. Una modalità di disegno null indica che l'utente può interagire con la mappa normalmente e i clic non disegnano nulla. Le modalità di disegno possibili sono null, "Point", "LineString" o "Polygon".
getFeatureById
getFeatureById(id)
Parametri: 
  • id:  number|string
Valore restituito:  Data.Feature|undefined
Restituisce la funzionalità con l'ID specificato, se esiste nella raccolta. In caso contrario, restituisce undefined.

Tieni presente che gli ID 1234 e '1234' sono equivalenti. Entrambi possono essere utilizzati per cercare la stessa funzionalità.
getMap
getMap()
Parametri: nessuno
Valore restituito:  Map
Restituisce la mappa su cui vengono visualizzate le funzionalità.
getStyle
getStyle()
Parametri: nessuno
Valore restituito:  Data.StylingFunction|Data.StyleOptions
Ottiene lo stile per tutte le funzionalità della raccolta.
loadGeoJson
loadGeoJson(url[, options, callback])
Parametri: 
Valore restituito:nessuno
Carica GeoJSON da un URL e aggiunge le funzionalità alla raccolta.

NOTA: il GeoJSON viene recuperato utilizzando XHR e potrebbe non funzionare tra domini diversi. Se riscontri problemi, ti consigliamo di recuperare il GeoJSON utilizzando la libreria AJAX che preferisci e poi chiamare addGeoJson().
overrideStyle
overrideStyle(feature, style)
Parametri: 
Valore restituito:nessuno
Modifica lo stile di una funzionalità. Queste modifiche vengono applicate in aggiunta allo stile specificato da setStyle(). Le proprietà di stile impostate su null vengono ripristinate al valore specificato tramite setStyle().
remove
remove(feature)
Parametri: 
Valore restituito:nessuno
Rimuove una funzionalità dalla raccolta.
revertStyle
revertStyle([feature])
Parametri: 
Valore restituito:nessuno
Rimuove l'effetto delle chiamate overrideStyle() precedenti. Lo stile della funzionalità specificata viene ripristinato allo stile specificato da setStyle().

Se non viene specificata alcuna funzionalità, lo stile di tutte le funzionalità viene ripristinato.
setControlPosition
setControlPosition(controlPosition)
Parametri: 
Valore restituito:nessuno
Imposta la posizione dei controlli di disegno sulla mappa.
setControls
setControls(controls)
Parametri: 
  • controls:  Array<string>
Valore restituito:nessuno
Imposta le modalità di disegno disponibili per la selezione da parte dell'utente, nell'ordine in cui vengono visualizzate. Non deve includere la modalità di disegno null, che viene aggiunta per impostazione predefinita. Se null, i controlli di disegno sono disattivati e non vengono visualizzati. Le modalità di disegno possibili sono "Point", "LineString" o "Polygon".
setDrawingMode
setDrawingMode(drawingMode)
Parametri: 
  • drawingMode:  string optional
Valore restituito:nessuno
Imposta la modalità di disegno corrente del livello dati specificato. Una modalità di disegno null indica che l'utente può interagire con la mappa normalmente e i clic non disegnano nulla. Le modalità di disegno possibili sono null, "Point", "LineString" o "Polygon".
setMap
setMap(map)
Parametri: 
Valore restituito:nessuno
Visualizza le funzionalità sulla mappa specificata. Se la mappa è impostata su null, gli elementi verranno rimossi dalla mappa.
setStyle
setStyle(style)
Parametri: 
Valore restituito:nessuno
Imposta lo stile per tutte le funzionalità della raccolta. Gli stili specificati per ogni funzionalità tramite overrideStyle() continuano a essere applicati.

Passa un oggetto con le opzioni di stile desiderate o una funzione che calcola lo stile per ogni funzionalità. La funzione verrà chiamata ogni volta che le proprietà di una funzionalità vengono aggiornate.
toGeoJson
toGeoJson(callback)
Parametri: 
  • callback:  function(Object): void
Valore restituito:nessuno
Esporta le funzionalità della raccolta in un oggetto GeoJSON.
Ereditato: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
addfeature
function(event)
Argomenti: 
Questo evento viene attivato quando una funzionalità viene aggiunta alla raccolta.
click
function(event)
Argomenti: 
Questo evento viene attivato per un clic sulla geometria.
contextmenu
function(event)
Argomenti: 
Questo evento viene attivato quando viene attivato l'evento DOM contextmenu sulla geometria.
dblclick
function(event)
Argomenti: 
Questo evento viene attivato per un doppio clic sulla geometria.
mousedown
function(event)
Argomenti: 
Questo evento viene attivato quando si preme il tasto del mouse sulla geometria.
mouseout
function(event)
Argomenti: 
Questo evento viene attivato quando il mouse esce dall'area della geometria.
mouseover
function(event)
Argomenti: 
Questo evento viene attivato quando il mouse entra nell'area della geometria.
mouseup
function(event)
Argomenti: 
Questo evento viene attivato quando si rilascia il pulsante del mouse sulla geometria.
removefeature
function(event)
Argomenti: 
Questo evento viene attivato quando una funzionalità viene rimossa dalla raccolta.
removeproperty
function(event)
Argomenti: 
Questo evento viene attivato quando viene rimossa la proprietà di una funzionalità.
setgeometry
function(event)
Argomenti: 
Questo evento viene attivato quando viene impostata la geometria di una funzionalità.
setproperty
function(event)
Argomenti: 
Questo evento viene attivato quando viene impostata una proprietà di una funzionalità.
rightclick
function(event)
Argomenti: 
Questo evento viene attivato per un clic con il tasto destro del mouse sulla geometria.

Interfaccia Data.DataOptions

google.maps.Data.DataOptions interfaccia

Oggetto DataOptions utilizzato per definire le proprietà che uno sviluppatore può impostare su un oggetto Data.
map
Tipo:  Map
Mappa su cui visualizzare le funzionalità della raccolta.
controlPosition optional
Tipo:  ControlPosition optional
Predefinito: ControlPosition.TOP_LEFT
La posizione dei controlli di disegno sulla mappa.
controls optional
Tipo:  Array<string> optional
Predefinito: null
Descrive le modalità di disegno disponibili per la selezione da parte dell'utente, nell'ordine in cui vengono visualizzate. Non deve includere la modalità di disegno null, che viene aggiunta per impostazione predefinita. Se null, i controlli di disegno sono disattivati e non vengono visualizzati. Le modalità di disegno possibili sono "Point", "LineString" o "Polygon".
drawingMode optional
Tipo:  string optional
Predefinito: null
La modalità di disegno attuale del livello dati specificato. Una modalità di disegno null indica che l'utente può interagire con la mappa normalmente e i clic non disegnano nulla. Le modalità di disegno possibili sono null, "Point", "LineString" o "Polygon".
featureFactory optional
Tipo:  function(Data.Geometry): Data.Feature optional
Quando il disegno è attivato e un utente disegna una geometria (un punto, una stringa di linea o un poligono), questa funzione viene chiamata con quella geometria e deve restituire una funzionalità da aggiungere al livello dati. Se non viene fornita una featureFactory, verrà creata una funzionalità senza ID e senza proprietà a partire da quella geometria. Il valore predefinito è null.
style optional
Stile per tutte le funzionalità della raccolta. Per maggiori dettagli, vedi il metodo setStyle() riportato sopra.

Data.GeoJsonOptions interfaccia

google.maps.Data.GeoJsonOptions interfaccia

Parametri facoltativi per l'importazione di GeoJSON.
idPropertyName optional
Tipo:  string optional
Il nome della proprietà Feature da utilizzare come ID funzionalità. Se non specificato, verrà utilizzato l'ID della funzionalità GeoJSON.

Data.StyleOptions interfaccia

google.maps.Data.StyleOptions interfaccia

Queste opzioni specificano l'aspetto di una funzionalità quando viene visualizzata su una mappa.
animation optional
Tipo:  Animation optional
L'animazione da riprodurre quando l'indicatore viene aggiunto a una mappa. Si applica solo alle geometrie a punti.
clickable optional
Tipo:  boolean optional
Predefinito: true
Se true, il marcatore riceve eventi attivati con il mouse e il tocco.
cursor optional
Tipo:  string optional
Cursore del mouse da mostrare al passaggio del mouse. Si applica solo alle geometrie a punti.
draggable optional
Tipo:  boolean optional
Predefinito: false
Se true, l'oggetto può essere trascinato sulla mappa e la geometria della funzionalità sottostante verrà aggiornata.
editable optional
Tipo:  boolean optional
Predefinito: false
Se true, l'oggetto può essere modificato trascinando i punti di controllo e la geometria della funzionalità sottostante verrà aggiornata. Si applica solo alle geometrie LineString e Polygon.
fillColor optional
Tipo:  string optional
Il colore di riempimento. Sono supportati tutti i colori CSS3, ad eccezione dei colori denominati estesi. Si applica solo alle geometrie poligonali.
fillOpacity optional
Tipo:  number optional
L'opacità del riempimento compresa tra 0,0 e 1,0. Si applica solo alle geometrie poligonali.
icon optional
Tipo:  string|Icon|Symbol optional
Icona per il primo piano. Se viene fornita una stringa, viene trattata come se fosse un Icon con la stringa come url. Si applica solo alle geometrie a punti.
icons optional
Tipo:  Array<IconSequence> optional
Le icone da visualizzare lungo una polilinea. Si applica solo alle geometrie delle linee.
label optional
Tipo:  string|MarkerLabel optional
Aggiunge un'etichetta al marcatore. L'etichetta può essere una stringa o un oggetto MarkerLabel. Si applica solo alle geometrie a punti.
opacity optional
Tipo:  number optional
L'opacità del marcatore, compresa tra 0,0 e 1,0. Si applica solo alle geometrie a punti.
shape optional
Tipo:  MarkerShape optional
Definisce la mappa immagine utilizzata per il rilevamento degli hit. Si applica solo alle geometrie a punti.
strokeColor optional
Tipo:  string optional
Il colore del tratto. Sono supportati tutti i colori CSS3, ad eccezione dei colori denominati estesi. Si applica solo alle geometrie di linee e poligoni.
strokeOpacity optional
Tipo:  number optional
L'opacità del tratto compresa tra 0,0 e 1,0. Si applica solo alle geometrie di linee e poligoni.
strokeWeight optional
Tipo:  number optional
La larghezza del tratto in pixel. Si applica solo alle geometrie di linee e poligoni.
title optional
Tipo:  string optional
Testo rollover. Si applica solo alle geometrie a punti.
visible optional
Tipo:  boolean optional
Predefinito: true
Indica se la funzionalità è visibile.
zIndex optional
Tipo:  number optional
Tutte le funzionalità vengono visualizzate sulla mappa in ordine di zIndex, con i valori più alti visualizzati davanti a quelli più bassi. I marcatori vengono sempre visualizzati davanti alle stringhe di linee e ai poligoni.

Data.StylingFunction typedef

google.maps.Data.StylingFunction typedef

Una funzione che calcola l'aspetto di una caratteristica.

Il metodo Data.setStyle() può accettare una funzione di stile. Utilizza questa opzione quando le funzionalità devono essere visualizzate in modo diverso a seconda delle loro proprietà. Puoi trovare maggiori informazioni sulle funzionalità di stile nella guida per gli sviluppatori.

function(Data.Feature): Data.StyleOptions

Data.Feature class

google.maps.Data.Feature classe

Una funzionalità ha una geometria, un ID e un insieme di proprietà.

Accesso chiamando il numero const {Data} = await google.maps.importLibrary("maps").
Consulta Librerie nell'API Maps JavaScript.
Data.Feature
Data.Feature([options])
Parametri: 
Crea una funzionalità con le opzioni specificate.
forEachProperty
forEachProperty(callback)
Parametri: 
  • callback:  function(*, string): void
Valore restituito:nessuno
Invoca ripetutamente la funzione specificata, passando un valore e un nome di proprietà a ogni invocazione. L'ordine di iterazione tra le proprietà non è definito.
getGeometry
getGeometry()
Parametri: nessuno
Valore restituito:  Data.Geometry
Restituisce la geometria della funzionalità.
getId
getId()
Parametri: nessuno
Valore restituito:  number|string|undefined
Restituisce l'ID della funzionalità.
getProperty
getProperty(name)
Parametri: 
  • name:  string
Valore restituito:  *
Restituisce il valore della proprietà richiesta o undefined se la proprietà non esiste.