KML

Klasse KmlLayer

google.maps.KmlLayer Kurs

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

Diese Klasse erweitert MVCObject.

Rufe const {KmlLayer} = await google.maps.importLibrary("maps") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
KmlLayer
KmlLayer([opts])
Parameter: 
Erstellt eine KmlLayer, die den Inhalt der angegebenen KML-/KMZ-Datei (https://developers.google.com/kml/documentation/kmlreference) oder GeoRSS-Datei (http://www.georss.org) rendert.
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
Status der Ebene abrufen, der festgelegt wird, sobald das angeforderte Dokument geladen wurde.
getUrl
getUrl()
Parameter:Keine
Rückgabewert:string-URL
Ruft die URL der angezeigten KML-Datei ab.
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: 
  • url:  string
Rückgabewert:Keiner
Hiermit wird die URL der KML-Datei festgelegt, die angezeigt werden soll.
setZIndex
setZIndex(zIndex)
Parameter: 
  • zIndex:  number Der Z-Index, der festgelegt werden soll.
Rückgabewert:Keiner
Hiermit wird der Z-Index der KML-Ebene festgelegt.
Übernommen: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 die KML-Ebene vollständig geladen wurde. An dieser Stelle können Sie die Statuseigenschaft lesen, um festzustellen, ob die Ebene erfolgreich geladen wurde.

KmlLayerOptions-Schnittstelle

google.maps.KmlLayerOptions Benutzeroberfläche

Dieses Objekt definiert die Eigenschaften, die für ein KmlLayer-Objekt festgelegt werden können.
clickable optional
Typ:boolean optional
Standard:true
Bei true empfängt die Ebene Mausereignisse.
map optional
Typ:Map optional
Die Karte, auf der die Ebene angezeigt wird.
preserveViewport optional
Typ:boolean optional
Standard:false
Wenn für diese Option 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 herangezoomt.
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 KML-Dokuments, das angezeigt werden soll.
zIndex optional
Typ:number optional
Der Z-Index der Ebene.

KmlLayerMetadata-Schnittstelle

google.maps.KmlLayerMetadata Benutzeroberfläche

Metadaten für eine einzelne KML-Ebene, angegeben im JSON-Format.
description
Typ:string
Die <description> der Ebene, aus dem Ebenen-Markup extrahiert.
hasScreenOverlays
Typ:boolean
Gibt an, ob die Ebene Bildschirm-Overlays hat.
name
Typ:string
Die <name> der Ebene, aus dem Ebenen-Markup extrahiert.
snippet
Typ:string
<Snippet> der Ebene, aus dem Ebenen-Markup extrahiert
author optional
Typ:KmlAuthor optional
Die <atom:author> der Ebene, aus dem Ebenen-Markup extrahiert.

Konstanten für KmlLayerStatus

google.maps.KmlLayerStatus constants

Der Status, der von KmlLayer nach dem Laden eines Dokuments zurückgegeben wird. Geben Sie diese Werte anhand des Werts oder des Namens der Konstante an. Beispiel: 'OK'oder google.maps.KmlLayerStatus.OK

Rufe const {KmlLayerStatus} = await google.maps.importLibrary("maps") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
DOCUMENT_NOT_FOUND Das Dokument konnte nicht gefunden werden. 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 Die Ebene wurde erfolgreich 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 Benutzeroberfläche

Die Eigenschaften eines Klick-Ereignisses bei einem KML/KMZ- oder GeoRSS-Dokument.
featureData
Ein KmlFeatureData-Objekt mit Informationen zum angeklickten Element.
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 Benutzeroberfläche

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
Der <atom:author> des Elements, der aus dem Ebenen-Markup extrahiert wird (falls angegeben).
description
Typ:string
Die <description> des Elements, aus dem Ebenen-Markup extrahiert.
id
Typ:string
Die <id> des Elements, aus dem Ebenen-Markup extrahiert. Wenn keine <id> angegeben wurde, wird für diese Funktion eine eindeutige ID generiert.
infoWindowHtml
Typ:string
Der Pop-up-Text des Merkmals, falls festgelegt.
name
Typ:string
Die <name> des Elements, aus dem Ebenen-Markup extrahiert.
snippet
Typ:string
Die <Snippet> des Elements, aus dem Ebenen-Markup extrahiert.

KmlAuthor-Schnittstelle

google.maps.KmlAuthor Benutzeroberfläche

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.