KML

KmlLayer-Klasse

google.maps.KmlLayer Klasse

Mit KmlLayer wird der Karte geografisches Markup aus einer KML-, KMZ- oder GeoRSS-Datei hinzugefügt, die auf einem öffentlich zugänglichen Webserver gehostet wird. Für jedes Feature wird beim Klicken ein KmlFeatureData-Objekt bereitgestellt.

Diese Klasse erweitert MVCObject.

Zugriff durch Anrufen von const {KmlLayer} = await google.maps.importLibrary("maps").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

KmlLayer
KmlLayer([opts])
Parameter:
Erstellt ein KmlLayer, mit dem der Inhalt der angegebenen KML-/KMZ-Datei (https://developers.google.com/kml/documentation/kmlreference) oder GeoRSS-Datei (http://www.georss.org) gerendert wird.
getDefaultViewport
getDefaultViewport()
Parameter:Keine
Rückgabewert:LatLngBounds
Ruft den Standarddarstellungsbereich für die angezeigte Ebene ab.
getMap
getMap()
Parameter:Keine
Rückgabewert:Map
Ruft die Karte ab, auf der die KML-Ebene wiedergegeben wird.
getMetadata
getMetadata()
Parameter:Keine
Rückgabewert:KmlLayerMetadata
Ruft die mit dieser Ebene verknüpften Metadaten ab, wie in der Ebenenauszeichnung angegeben.
getStatus
getStatus()
Parameter:Keine
Rückgabewert:KmlLayerStatus
Rufen Sie den Status der Ebene ab, der festgelegt wird, sobald das angeforderte Dokument geladen wurde.
getUrl
getUrl()
Parameter:Keine
Rückgabewert:string-URL
Gibt die URL der angezeigten KML-Datei zurück.
getZIndex
getZIndex()
Parameter:Keine
Rückgabewert:number Der Z-Index.
Ruft den Z-Index der KML-Ebene ab.
setMap
setMap(map)
Parameter:
Rückgabewert:Keiner
Gibt die KML-Ebene auf der angegebenen Karte wieder. Wenn „map“ auf null gesetzt ist, wird die Ebene entfernt.
setOptions
setOptions(options)
Parameter:
Rückgabewert:Keiner
setUrl
setUrl(url)
Parameter:
  • urlstring
Rückgabewert:Keiner
Legt die URL der anzuzeigenden KML-Datei fest.
setZIndex
setZIndex(zIndex)
Parameter:
  • zIndexnumber Der festzulegende Z-Index.
Rückgabewert:Keiner
Legt den Z-Index der KML-Ebene fest.
Geerbt:addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(kmlClickEvent)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn eine Funktion auf der Ebene angeklickt wird.
defaultviewport_changed
function()
Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich der standardmäßige Darstellungsbereich der KML-Ebene geändert hat.
status_changed
function()
Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn das Laden der KML-Ebene abgeschlossen ist. An diesem Punkt können Sie die Status-Eigenschaft lesen, um festzustellen, ob die Ebene erfolgreich geladen wurde.

KmlLayerOptions Schnittstelle

google.maps.KmlLayerOptions-Schnittstelle

Dieses Objekt definiert die Eigenschaften, die für ein KmlLayer-Objekt festgelegt werden können.

clickable optional
Typ:boolean optional
Standard:true
Wenn true, empfängt der Layer Mausereignisse.
map optional
Typ:Map optional
Die Karte, auf der die Ebene angezeigt wird.
preserveViewport optional
Typ:boolean optional
Standard:false
Wenn diese Option auf true festgelegt ist oder die Mitte und der Zoom der Karte nie festgelegt wurden, wird die Eingabekarte auf den Begrenzungsrahmen des Inhalts der Ebene zentriert und gezoomt.
screenOverlays optional
Typ:boolean optional
Standard:true
Gibt an, ob die Bildschirm-Overlays gerendert werden sollen.
suppressInfoWindows optional
Typ:boolean optional
Unterdrückt die Wiedergabe von Infofenstern, wenn Ebenenmerkmale angeklickt werden.
url optional
Typ:string optional
Die URL des anzuzeigenden KML-Dokuments.
zIndex optional
Typ:number optional
Der Z-Index der Ebene.

KmlLayerMetadata-Schnittstelle

google.maps.KmlLayerMetadata-Schnittstelle

Metadaten für eine einzelne KML-Ebene, angegeben im JSON-Format.

description
Typ:string
Die <description> der Ebene, die aus dem Ebenen-Markup extrahiert wurde.
hasScreenOverlays
Typ:boolean
Gibt an, ob die Ebene Bildschirm-Overlays enthält.
name
Typ:string
Die <name> der Ebene, die aus dem Ebenen-Markup extrahiert wurde.
snippet
Typ:string
<Snippet> der Ebene, aus dem Ebenen-Markup extrahiert
author optional
Typ:KmlAuthor optional
Die <atom:author> der Ebene, die aus dem Ebenen-Markup extrahiert wurde.

KmlLayerStatus-Konstanten

google.maps.KmlLayerStatus Konstanten

Der Status, der von KmlLayer zurückgegeben wird, wenn das Laden eines Dokuments abgeschlossen ist. Geben Sie diese nach Wert oder mit dem Namen der Konstante an. Beispiel: 'OK'oder google.maps.KmlLayerStatus.OK

Zugriff durch Anrufen von const {KmlLayerStatus} = await google.maps.importLibrary("maps").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

DOCUMENT_NOT_FOUND Das Dokument wurde nicht gefunden. Höchstwahrscheinlich ist die URL ungültig oder das Dokument ist nicht öffentlich verfügbar.
DOCUMENT_TOO_LARGE Das Dokument überschreitet die Dateigrößenbeschränkungen von KmlLayer.
FETCH_ERROR Das Dokument konnte nicht abgerufen werden.
INVALID_DOCUMENT Das Dokument ist kein gültiges KML-, KMZ- oder GeoRSS-Dokument.
INVALID_REQUEST KmlLayer ist ungültig.
LIMITS_EXCEEDED Das Dokument überschreitet die Elementlimits von KmlLayer.
OK Der Layer wurde geladen.
TIMED_OUT Das Dokument konnte nicht in einem angemessenen Zeitraum geladen werden.
UNKNOWN Das Dokument konnte aus unbekanntem Grund nicht geladen werden.

KmlMouseEvent-Schnittstelle

google.maps.KmlMouseEvent-Schnittstelle

Die Eigenschaften eines Klick-Ereignisses bei einem KML/KMZ- oder GeoRSS-Dokument.

featureData
Ein KmlFeatureData-Objekt mit Informationen zum angeklickten Kartenelement.
latLng
Typ:LatLng
Die Position, an der ein Infofenster auf dem angeklickten Merkmal verankert werden soll.
pixelOffset
Typ:Size
Der Abstand, der zwischen einem Infofenster und seiner Verankerung auf dem angeklickten Merkmal bestehen soll.

KmlFeatureData-Schnittstelle

google.maps.KmlFeatureData-Schnittstelle

Daten für ein einzelnes KML-Merkmal im JSON-Format, die beim Anklicken eines KML-Merkmals zurückgegeben werden. Die in diesem Objekt enthaltenen Daten spiegeln die Daten wieder, die dem Merkmal in der KML- oder GeoRSS-Auszeichnung zugewiesen sind, in der sie deklariert werden.

author
Die <atom:author> der Funktion, die aus dem Layermarkup extrahiert wird (falls angegeben).
description
Typ:string
Das <description> des Features, das aus dem Layermarkup extrahiert wurde.
id
Typ:string
Das <id> des Features, das aus dem Layermarkup extrahiert wurde. Wenn kein <id> angegeben wurde, wird eine eindeutige ID für diese Funktion generiert.
infoWindowHtml
Typ:string
Der Pop-up-Text des Merkmals, falls festgelegt.
name
Typ:string
Das <name> des Features, das aus dem Layermarkup extrahiert wurde.
snippet
Typ:string
Das <Snippet> des Features, das aus dem Layermarkup extrahiert wurde.

KmlAuthor-Schnittstelle

google.maps.KmlAuthor-Schnittstelle

Enthält Details zum Autor eines KML-Dokuments oder einer KML-Funktion.

email
Typ:string
E-Mail-Adresse des Autors; falls nicht angegeben, eine leere Zeichenfolge.
name
Typ:string
Name des Autors; falls nicht angegeben, eine leere Zeichenfolge.
uri
Typ:string
Homepage des Autors; falls nicht angegeben, eine leere Zeichenfolge.