KML

Classe KmlLayer

google.maps.KmlLayer classe

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

Questo corso si estende MVCObject.

Accesso chiamando il numero const {KmlLayer} = await google.maps.importLibrary("maps").
Consulta Librerie nell'API Maps JavaScript.

Costruttore
KmlLayer	KmlLayer([opts]) Parametri:  opts:  KmlLayerOptions optional Opzioni per questo livello. Crea un 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).

Metodi
getDefaultViewport	getDefaultViewport() Parametri: nessuno Valore restituito:  LatLngBounds Recupera 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 Ottieni lo stato del livello, impostato una volta caricato il 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:  map:  Map Valore restituito:nessuno Visualizza il livello KML sulla mappa specificata. Se la mappa è impostata su null, il livello viene rimosso.
setOptions	setOptions(options) Parametri:  options:  KmlLayerOptions 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

Eventi
click	function(kmlClickEvent) Argomenti:  kmlClickEvent:  KmlMouseEvent Questo evento viene attivato quando viene fatto clic su una funzionalità del 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, puoi leggere la proprietà di 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.

Proprietà
clickable optional	Tipo:  boolean optional Predefinito: 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 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 lo zoom viene impostato sulla casella di selezione dei contenuti del livello.
screenOverlays optional	Tipo:  boolean optional Predefinito: true Specifica se eseguire il rendering degli overlay schermo.
suppressInfoWindows optional	Tipo:  boolean optional Elimina il rendering delle finestre informative 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 L'indice z del livello.

Interfaccia KmlLayerMetadata

google.maps.KmlLayerMetadata interfaccia

Metadati per un singolo livello KML, in formato JSON.

Proprietà
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
author optional	Tipo:  KmlAuthor optional Il <atom:author> 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 per valore o utilizzando il nome della costante. Ad esempio, 'OK' o google.maps.KmlLayerStatus.OK

Accesso chiamando il numero const {KmlLayerStatus} = await google.maps.importLibrary("maps").
Consulta Librerie nell'API Maps JavaScript.

Costanti
DOCUMENT_NOT_FOUND	Impossibile trovare il documento. Molto probabilmente l'URL non è valido o il documento non è disponibile pubblicamente.
DOCUMENT_TOO_LARGE	Il documento supera i limiti di dimensioni 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 delle funzionalità di KmlLayer.
OK	Il livello è stato caricato correttamente.
TIMED_OUT	Non è stato possibile caricare il documento in un lasso di tempo ragionevole.
UNKNOWN	Il documento non è stato caricato per un motivo sconosciuto.

KmlMouseEvent interfaccia

google.maps.KmlMouseEvent interfaccia

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

Proprietà
featureData	Tipo:  KmlFeatureData Un oggetto KmlFeatureData contenente informazioni sulla funzionalità su cui è stato fatto clic.
latLng	Tipo:  LatLng La posizione in cui ancorare una finestra informativa alla funzionalità selezionata.
pixelOffset	Tipo:  Size L'offset da applicare a una finestra informativa ancorata alla funzionalità selezionata.

Interfaccia KmlFeatureData

google.maps.KmlFeatureData interfaccia

Dati per una singola funzionalità KML in formato JSON, restituiti quando si fa clic su una funzionalità KML. I dati contenuti in questo oggetto rispecchiano quelli associati alla funzionalità nel markup KML o GeoRSS in cui è dichiarata.

Proprietà
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 non è stato specificato alcun <id>, verrà generato un ID univoco per questa funzionalità.
infoWindowHtml	Tipo:  string Il testo in stile fumetto della funzionalità, se impostato.
name	Tipo:  string <name> della funzionalità, estratto dal markup del livello.
snippet	Tipo:  string <Snippet> della funzionalità, estratto dal markup del livello.

KmlAuthor KmlAuthor

google.maps.KmlAuthor interfaccia

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

Proprietà
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.