KML

Classe KmlLayer

google.maps.KmlLayer corso

Un KmlLayer aggiunge alla mappa il markup geografico da un file KML, KMZ o GeoRSS ospitato su un server web accessibile al pubblico. Quando fai clic su una funzionalità, viene fornito un oggetto KmlFeatureData.

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 KmlLayer che mostra i 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
Recupera l'area visibile predefinita per il livello visualizzato.
getMap
getMap()
Parametri: nessuno
Valore restituito:Map
Recupera la mappa su cui viene visualizzato il livello KML.
getMetadata
getMetadata()
Parametri: nessuno
Valore restituito:KmlLayerMetadata
Recupera i metadati associati a questo livello, come specificato nel markup del livello.
getStatus
getStatus()
Parametri: nessuno
Valore restituito:KmlLayerStatus
Recupera 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 l'indice z.
Recupera lo z-index del livello KML.
setMap
setMap(map)
Parametri: 
Valore restituito:nessuno
Esegue il rendering del 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 l'indice z da impostare.
Valore restituito:nessuno
Imposta l'indice z del livello KML.
Ereditato: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(kmlClickEvent)
Argomenti: 
Questo evento viene attivato quando si fa clic su un elemento nel livello.
defaultviewport_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando il viewport predefinito dei livelli KML è cambiato.
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

google.maps.KmlLayerOptions interfaccia

Questo oggetto definisce le proprietà che possono essere impostate su un oggetto KmlLayer.
clickable optional
Tipo:  boolean optional
Valore predefinito: true
Se true, il livello riceve gli eventi del mouse.
map optional
Tipo:  Map optional
La mappa su cui visualizzare il livello.
preserveViewport optional
Tipo:  boolean optional
Valore 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 viene centrata e viene applicato lo zoom al riquadro delimitante dei contenuti del livello.
screenOverlays optional
Tipo:  boolean optional
Valore predefinito: true
Indica se eseguire il rendering degli overlay schermo.
suppressInfoWindows optional
Tipo:  boolean optional
Elimina il rendering delle finestre di informazioni quando si fa 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 di un singolo livello KML in formato JSON.
author
Tipo:  KmlAuthor
Il <atom:author> del livello, estratto dal markup del livello.
description
Tipo:  string
Il <description> del livello, estratto dal markup del livello.
hasScreenOverlays
Tipo:  boolean
Indica se il livello contiene overlay schermo.
name
Tipo:  string
Il <name> del livello, estratto dal markup del livello.
snippet
Tipo:  string
Il <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 il documento non è disponibile pubblicamente.
DOCUMENT_TOO_LARGE Il documento supera i limiti di dimensione dei file di KmlLayer.
FETCH_ERROR Impossibile recuperare il documento.
INVALID_DOCUMENT Il documento non è un documento KML, KMZ o GeoRSS valido.
INVALID_REQUEST Il valore KmlLayer non è valido.
LIMITS_EXCEEDED Il documento supera i limiti di elementi di KmlLayer.
OK Il livello è stato caricato correttamente.
TIMED_OUT Non è stato possibile caricare il documento in un lasso di tempo ragionevole.
UNKNOWN Il caricamento del documento non è riuscito per un motivo sconosciuto.

Interfaccia KmlMouseEvent

google.maps.KmlMouseEvent interfaccia

Le proprietà di un evento di clic su un documento KML/KMZ o GeoRSS.
featureData
Un oggetto KmlFeatureData contenente informazioni sulla funzionalità su cui è stato fatto clic.
latLng
Tipo:  LatLng
La posizione a cui ancorare una finestra informativa sulla funzionalità su cui è stato fatto clic.
pixelOffset
Tipo:  Size
Lo spazio da applicare a una finestra informativa ancorata alla funzionalità su cui è stato fatto clic.

Interfaccia KmlFeatureData

google.maps.KmlFeatureData interfaccia

Dati di un singolo elemento KML in formato JSON, restituiti quando si fa clic su un elemento KML. I dati contenuti in questo oggetto rispecchiano quelli associati alla funzionalità nel markup KML o GeoRSS in cui è dichiarata.
author
Tipo:  KmlAuthor
Il <atom:author> della funzionalità, estratto dal markup del livello (se specificato).
description
Tipo:  string
Il <description> della funzionalità, estratto dal markup del livello.
id
Tipo:  string
Il <id> della funzionalità, estratto dal markup del livello. Se non è stato specificato alcun <id>, verrà generato un ID univoco per questa funzionalità.
infoWindowHtml
Tipo:  string
Il testo con stile a fumetto della funzionalità, se impostato.
name
Tipo:  string
Il <name> della funzionalità, estratto dal markup del livello.
snippet
Tipo:  string
Il <Snippet> della funzionalità, estratto dal markup del livello.

Interfaccia KmlAuthor

google.maps.KmlAuthor interfaccia

Contiene i dettagli dell'autore di un documento o elemento KML.
email
Tipo:  string
L'indirizzo email dell'autore o una stringa vuota se non specificato.
name
Tipo:  string
Il nome dell'autore o una stringa vuota se non specificato.
uri
Tipo:  string
La home page dell'autore o una stringa vuota se non specificata.