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.
Costruttore | |
---|---|
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). |
Metodi | |
---|---|
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 URLRecupera 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:
Valore di restituzione: nessuno
Imposta l'URL del file KML da visualizzare. |
setZIndex |
setZIndex(zIndex) Parametri:
Valore di restituzione: nessuno
Imposta lo z-index del livello KML. |
Ereditata:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventi | |
---|---|
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
.
Proprietà | |
---|---|
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.
Proprietà | |
---|---|
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.
Costanti | |
---|---|
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.
Proprietà | |
---|---|
featureData |
Tipo:
KmlFeatureData 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.
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 <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.
Proprietà | |
---|---|
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. |