KML

Classe KmlLayer

lezione google.maps.KmlLayer

KmlLayer aggiunge un markup geografico alla mappa da un file KML, TTM o GeoRSS ospitato su un server web accessibile pubblicamente. Quando viene fatto clic su un elemento, viene fornito un oggetto KmlFeatureData per ogni funzionalità.

Questo corso estende MVCObject.

Accedi chiamando const {KmlLayer} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

KmlLayer
KmlLayer([opts])
Parametri: 
Crea una KmlLayer che esegue il rendering dei contenuti del file KML/KMZ specificato (https://developers.google.com/creare file/documento/KML) o del file GeoRSS (http://www.georss.org).
getDefaultViewport
getDefaultViewport()
Parametri: nessuno
Valore restituito:  LatLngBounds
Visualizza l'area visibile predefinita per il livello visualizzato.
getMap
getMap()
Parametri: nessuno
Valore restituito:  Map
Visualizza la mappa su cui viene eseguito il rendering del livello KML.
getMetadata
getMetadata()
Parametri: nessuno
Valore restituito:  KmlLayerMetadata
Ottieni i metadati associati a questo livello, come specificato nel markup del livello.
getStatus
getStatus()
Parametri: nessuno
Valore restituito:  KmlLayerStatus
Ottieni lo stato del livello, impostato una volta caricato il documento richiesto.
getUrl
getUrl()
Parametri: nessuno
Valore di restituzione:  string URL
Recupera l'URL del file KML visualizzato.
getZIndex
getZIndex()
Parametri: nessuno
Valore di ritorno:  number lo z-index.
Visualizza lo z-index del livello KML.
setMap
setMap(map)
Parametri: 
Valore di restituzione: nessuno
Visualizza il livello KML sulla mappa specificata. Se la mappa è impostata su null, il livello viene rimosso.
setOptions
setOptions(options)
Parametri: 
Valore di restituzione: nessuno
setUrl
setUrl(url)
Parametri: 
  • urlstring
Valore di restituzione: nessuno
Imposta l'URL del file KML da visualizzare.
setZIndex
setZIndex(zIndex)
Parametri: 
  • zIndexnumber lo z-index da impostare.
Valore di restituzione: nessuno
Imposta lo z-index del livello KML.
Ereditata: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(kmlClickEvent)
Argomenti: 
Questo evento viene attivato quando viene fatto clic su un elemento nel livello.
defaultviewport_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando l'area visibile predefinita dei livelli KML è cambiata.
status_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando il caricamento del livello KML è terminato. A questo punto, è possibile leggere la proprietà dello stato per determinare se il livello è stato caricato correttamente.

Interfaccia KmlLayerOptions

google.maps.KmlLayerOptions interfaccia

Questo oggetto definisce le proprietà che possono essere impostate su un oggetto KmlLayer.

clickable optional
Tipo:  boolean optional
Predefinito: true
Se true, il livello riceve eventi mouse.
map optional
Tipo:  Map optional
La mappa su cui visualizzare il livello.
preserveViewport optional
Tipo:  boolean optional
Predefinito: false
Se questa opzione è impostata su true o se il centro e lo zoom della mappa non sono mai stati impostati, la mappa di input è centrata e ingrandita sul riquadro di delimitazione dei contenuti del livello.
screenOverlays optional
Tipo:  boolean optional
Predefinito: true
Indica se mostrare gli overlay dello schermo.
suppressInfoWindows optional
Tipo:  boolean optional
Disattiva il rendering delle finestre informative quando viene fatto clic sulle funzionalità del livello.
url optional
Tipo:  string optional
L'URL del documento KML da visualizzare.
zIndex optional
Tipo:  number optional
Lo z-index del livello.

Interfaccia KmlLayerMetadata

google.maps.KmlLayerMetadata interfaccia

Metadati per un singolo livello KML, in formato JSON.

author
Tipo:  KmlAuthor
Il livello <atom:author>, estratto dal markup del livello.
description
Tipo:  string
Il livello <description>, estratto dal markup del livello.
hasScreenOverlays
Tipo:  boolean
Indica se il livello ha overlay dello schermo.
name
Tipo:  string
Il livello <name>, estratto dal markup del livello.
snippet
Tipo:  string
Il livello <Snippet>, estratto dal markup del livello

Costanti di KmlLayerStatus

google.maps.KmlLayerStatus costanti

Lo stato restituito da KmlLayer al termine del caricamento di un documento. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'OK' o google.maps.KmlLayerStatus.OK.

Accedi chiamando const {KmlLayerStatus} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

DOCUMENT_NOT_FOUND Impossibile trovare il documento. Molto probabilmente si tratta di un URL non valido o il documento non è disponibile pubblicamente.
DOCUMENT_TOO_LARGE Il documento supera i limiti di dimensioni del file di KmlLayer.
FETCH_ERROR Impossibile recuperare il documento.
INVALID_DOCUMENT Il documento non è un documento KML, TTM o GeoRSS valido.
INVALID_REQUEST KmlLayer non è valido.
LIMITS_EXCEEDED Il documento supera i limiti di funzionalità di KmlLayer.
OK Livello caricato correttamente.
TIMED_OUT Non è stato possibile caricare il documento entro un lasso di tempo ragionevole.
UNKNOWN Impossibile caricare il documento per un motivo sconosciuto.

Interfaccia KmlMouseEvent

google.maps.KmlMouseEvent interfaccia

Le proprietà di un evento clic su un documento KML/KMZ o GeoRSS.

featureData
Un oggetto KmlFeatureData, contenente informazioni sulla funzionalità selezionata.
latLng
Tipo:  LatLng
La posizione in cui deve essere ancorata una finestra informativa sulla funzionalità selezionata.
pixelOffset
Tipo:  Size
L'offset da applicare a una finestra informativa ancorata alla funzionalità selezionata.

Interfaccia KmlFeatureData

google.maps.KmlFeatureData interfaccia

Dati relativi a una singola funzionalità KML in formato JSON che viene restituito quando viene fatto clic su una funzionalità KML. I dati contenuti in questo oggetto rispecchiano quelli associati alla funzionalità nel markup KML o GeoRSS in cui viene dichiarato.

author
Tipo:  KmlAuthor
Il <atom:author> della funzionalità, estratto dal markup del livello (se specificato).
description
Tipo:  string
<description> della funzionalità, estratto dal markup del livello.
id
Tipo:  string
<id> della funzionalità, estratto dal markup del livello. Se <id> non è stato specificato, verrà generato un ID univoco per questa funzionalità.
infoWindowHtml
Tipo:  string
Il testo con lo stile fumetto dell'elemento, se impostato.
name
Tipo:  string
<name> della funzionalità, estratto dal markup del livello.
snippet
Tipo:  string
<Snippet> della funzionalità, estratto dal markup del livello.

Interfaccia KmlAuthor

google.maps.KmlAuthor interfaccia

Contiene i dettagli dell'autore di un documento o di una funzionalità KML.

email
Tipo:  string
L'indirizzo email dell'autore o una stringa vuota, se non specificata.
name
Tipo:  string
Il nome dell'autore o una stringa vuota se non specificata.
uri
Tipo:  string
La home page dell'autore o una stringa vuota, se non specificata.