KML

Classe KmlLayer

google.maps.KmlLayer classe

Un elemento KmlLayer aggiunge un markup geografico alla mappa da un file KML, KMZ o GeoRSS ospitato su un server web pubblicamente accessibile. Per ciascuna funzionalità viene fornito un oggetto KmlFeatureData quando viene fatto clic.

Questa classe estende MVCObject.

Accedi chiamando const {KmlLayer} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.
KmlLayer
KmlLayer([opts])
Parametri: 
Crea un elemento KmlLayer che esegue il rendering dei contenuti del file KML/KMZ specificato (https://developers.google.com/kml/documentation/kmlreference) o del file GeoRSS (http://www.georss.org).
getDefaultViewport
getDefaultViewport()
Parametri: nessuno
Valore restituito:  LatLngBounds
Ottieni l'area visibile predefinita per il livello visualizzato.
getMap
getMap()
Parametri: nessuno
Valore restituito:  Map
Ottieni 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
Visualizza lo stato del livello, impostato dopo il caricamento del documento richiesto.
getUrl
getUrl()
Parametri: nessuno
Valore restituito:  string URL
Recupera l'URL del file KML visualizzato.
getZIndex
getZIndex()
Parametri: nessuno
Valore restituito:  number il valore z-index.
Recupera lo z-index del livello KML.
setMap
setMap(map)
Parametri: 
Valore restituito: nessuno
Visualizza il livello KML sulla mappa specificata. Se la mappa è impostata su null, il livello viene rimosso.
setOptions
setOptions(options)
Parametri: 
Valore restituito: nessuno
setUrl
setUrl(url)
Parametri: 
  • url:  string
Valore restituito: nessuno
Imposta l'URL del file KML da visualizzare.
setZIndex
setZIndex(zIndex)
Parametri: 
  • zIndex:  number lo z-index da impostare.
Valore restituito: nessuno
Imposta lo z-index del livello KML.
Ereditate: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(kmlClickEvent)
Argomenti: 
Questo evento viene attivato quando viene fatto clic su una caratteristica nel livello.
defaultviewport_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando l'area visibile predefinita dei livelli KML viene modificata.
status_changed
function()
Argomenti: nessuno
Questo evento viene attivato al termine del caricamento del livello KML. A questo punto è possibile leggere la proprietà status per determinare se il livello è stato caricato correttamente.

Interfaccia KmlLayerOptions

Interfaccia google.maps.KmlLayerOptions

Questo oggetto definisce le proprietà che possono essere impostate su un oggetto KmlLayer.
clickable optional
Tipo:  boolean optional
Predefinita: true
Se true, il livello riceve eventi del mouse.
map optional
Tipo:  Map optional
La mappa su cui visualizzare il livello.
preserveViewport optional
Tipo:  boolean optional
Predefinita: 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 viene centrata e ingrandita rispetto al riquadro di delimitazione dei contenuti del livello.
screenOverlays optional
Tipo:  boolean optional
Predefinita: true
Se eseguire il rendering degli overlay schermo.
suppressInfoWindows optional
Tipo:  boolean optional
Elimina il rendering delle finestre informative quando fai clic sulle funzionalità dei livelli.
url optional
Tipo:  string optional
L'URL del documento KML da visualizzare.
zIndex optional
Tipo:  number optional
Lo z-index del livello.

Interfaccia KmlLayerMetadata

Interfaccia google.maps.KmlLayerMetadata

Metadati per un singolo livello KML in formato JSON.
author
Tipo:  KmlAuthor
<atom:author> del livello, estratto dal markup del livello.
description
Tipo:  string
<description> del livello, estratto dal markup del livello.
hasScreenOverlays
Tipo:  boolean
Se il livello ha sovrapposizioni sullo schermo.
name
Tipo:  string
<name> del livello, estratto dal markup del livello.
snippet
Tipo:  string
<Snippet> del livello, estratto dal markup del livello

Costanti KmlLayerStatus

google.maps.KmlLayerStatus costanti

Lo stato restituito da KmlLayer al termine del caricamento di un documento. Specificali 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 del documento non è disponibile pubblicamente.
DOCUMENT_TOO_LARGE Le dimensioni del documento superano i limiti di dimensione del file di Kml Layer.
FETCH_ERROR Impossibile recuperare il documento.
INVALID_DOCUMENT Il documento non è un documento KML, KMZ o GeoRSS valido.
INVALID_REQUEST KmlLayer non valido.
LIMITS_EXCEEDED Il documento supera i limiti di funzionalità di Kmllayer.
OK Il livello è stato caricato.
TIMED_OUT Non è stato possibile caricare il documento entro un periodo di tempo ragionevole.
UNKNOWN Impossibile caricare il documento per un motivo sconosciuto.

Interfaccia di KmlMouseEvent

Interfaccia google.maps.KmlMouseEvent

Le proprietà di un evento di clic in un documento KML/KMZ o GeoRSS.
featureData
Un oggetto KmlFeatureData, contenente informazioni sulla funzionalità selezionata.
latLng
Tipo:  LatLng
La posizione in cui ancorare una finestra informativa all'elemento selezionato.
pixelOffset
Tipo:  Size
L'offset da applicare a una finestra informativa ancorata all'elemento selezionato.

Interfaccia KmlFeatureData

Interfaccia google.maps.KmlFeatureData

Dati relativi a una singola funzionalità KML in formato JSON, restituiti quando viene fatto clic su una funzionalità KML. I dati contenuti in questo oggetto rispecchiano quelli associati all'elemento nel markup KML o GeoRSS in cui è stato dichiarato.
author
Tipo:  KmlAuthor
<atom:author> dell'elemento, estratto dal markup del livello (se specificato).
description
Tipo:  string
<description> dell'elemento, estratto dal markup del livello.
id
Tipo:  string
<id> dell'elemento, estratto dal markup del livello. Se non è stato specificato alcun <id>, verrà generato un ID univoco per questa funzionalità.
infoWindowHtml
Tipo:  string
Testo in stile fumetto dell'elemento, se impostato.
name
Tipo:  string
<name> dell'elemento, estratto dal markup del livello.
snippet
Tipo:  string
<Snippet> dell'elemento, estratto dal markup del livello.

Interfaccia di KmlAuthor

Interfaccia google.maps.KmlAuthor

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.