KML

Classe KmlLayer

class google.maps.KmlLayer extends MVCObject
library "maps" 

const {KmlLayer} = await google.maps.importLibrary("maps");
KmlLayer
KmlLayer([opts])
Parametri:
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).
getDefaultViewport
getDefaultViewport()
Parametri: nessuno
Valore restituito: LatLngBounds|null
Recupera l'area visibile predefinita per il livello visualizzato.
getMap
getMap()
Parametri: nessuno
Valore restituito: Map|null
Recupera la mappa su cui viene eseguito il rendering del livello KML.
getMetadata
getMetadata()
Parametri: nessuno
Valore restituito: KmlLayerMetadata|null
Recupera i metadati associati a questo livello, come specificato nel markup del livello.
getStatus
getStatus()
Parametri: nessuno
Valore restituito: KmlLayerStatus|null
Recupera lo stato del livello, impostato una volta caricato il documento richiesto.
getUrl
getUrl()
Parametri: nessuno
Valore restituito: URL string
Recupera l'URL del file KML visualizzato.
getZIndex
getZIndex()
Parametri: nessuno
Valore restituito: number lo z-index.
Recupera lo z-index del livello KML.
setMap
setMap(map)
Parametri:
  • map: Map optional
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 Lo z-index da impostare.
Valore restituito: nessuno
Imposta l'indice z del livello KML.
Ereditate: 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 l'area visibile predefinita dei livelli KML è cambiata.
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
facoltativo
Tipo: boolean optional
Valore predefinito: true
Se true, il livello riceve gli eventi del mouse.
map
facoltativo
Tipo: Map optional
La mappa su cui visualizzare il livello.
preserveViewport
facoltativo
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 ingrandita in base al riquadro di delimitazione dei contenuti del livello.
screenOverlays
facoltativo
Tipo: boolean optional
Valore predefinito: true
Indica se eseguire il rendering degli overlay sullo schermo.
suppressInfoWindows
facoltativo
Tipo: boolean optional
Elimina il rendering delle finestre informative quando si fa clic sulle caratteristiche del livello.
url
facoltativo
Tipo: string optional
L'URL del documento KML da visualizzare.
zIndex
facoltativo
Tipo: number optional
Lo z-index del livello.

Interfaccia KmlLayerMetadata

interfaccia google.maps.KmlLayerMetadata

Metadati per un singolo livello KML, in formato JSON.
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
<Snippet> del livello, estratto dal markup del livello
author
facoltativo
Tipo: KmlAuthor optional
Il <atom:author> del livello, estratto dal markup del livello.

Costanti KmlLayerStatus

constants google.maps.KmlLayerStatus
library "maps"

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

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo KmlLayerStatusString.

const {KmlLayerStatus} = await google.maps.importLibrary("maps");
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 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 Impossibile caricare il documento per un motivo sconosciuto.

Interfaccia KmlMouseEvent

interfaccia google.maps.KmlMouseEvent

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 in cui ancorare una finestra informativa sulla caratteristica selezionata.
pixelOffset
Tipo: Size
L'offset da applicare a una finestra informativa ancorata alla funzionalità selezionata.

Interfaccia KmlFeatureData

interfaccia google.maps.KmlFeatureData

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.
author
Tipo: KmlAuthor
<atom:author> della funzionalità, 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
Il testo con stile del fumetto della funzionalità, 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 KmlAuthor

interfaccia google.maps.KmlAuthor

Contiene i dettagli dell'autore di un documento o di un 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.