KML

KmlLayer-Klasse

google.maps.KmlLayer Klasse

Ein KmlLayer fügt der Karte geografisches Markup aus einer KML-, KMZ- oder GeoRSS-Datei hinzu, die auf einem öffentlich zugänglichen Webserver gehostet wird. Für jedes angeklickte Element wird ein KmlFeatureData-Objekt bereitgestellt.

Diese Klasse erweitert MVCObject.

Zugriff über const {KmlLayer} = await google.maps.importLibrary("maps") aufrufen. 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
Ruft den Status der Ebene ab. Dieser wird festgelegt, nachdem 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:Keine
Gibt die KML-Ebene auf der angegebenen Karte wieder. Wenn für die Karte null festgelegt ist, wird die Ebene entfernt.
setOptions
setOptions(options)
Parameter:
Rückgabewert:Keine
setUrl
setUrl(url)
Parameter:
  • url:  string
Rückgabewert:Keine
Legt die URL der anzuzeigenden KML-Datei fest.
setZIndex
setZIndex(zIndex)
Parameter:
  • zIndex:  number Der festzulegende Z-Index.
Rückgabewert:Keine
Legt den Z-Index der KML-Ebene fest.
Ü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 das Laden der KML-Ebene abgeschlossen ist. An dieser Stelle kann die Statuseigenschaft gelesen werden, 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
Standardwert: 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
Standardwert: false
Wenn diese Option auf true gesetzt ist oder wenn Mittelpunkt und Zoom der Karte nie festgelegt wurden, wird die Eingabekarte zentriert und auf den Begrenzungsrahmen des Inhalts der Ebene gezoomt.
screenOverlays optional
Typ:boolean optional
Standardwert: 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
Z-Index der Ebene

KmlLayerMetadata-Schnittstelle

google.maps.KmlLayerMetadata-Schnittstelle

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

KmlLayerStatus-Konstanten

google.maps.KmlLayerStatus-Konstanten

Der von KmlLayer nach Abschluss des Ladens eines Dokuments zurückgegebene Status. Geben Sie diese mit dem Wert oder dem Namen der Konstante an. Beispiel: 'OK'oder google.maps.KmlLayerStatus.OK

Zugriff über const {KmlLayerStatus} = await google.maps.importLibrary("maps") aufrufen. 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 Featurebeschränkungen von KmlLayer.
OK Die Ebene wurde geladen.
TIMED_OUT Das Dokument konnte nicht innerhalb eines angemessenen Zeitraums 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, das Informationen zum angeklickten Element enthält.
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
<atom:author> des Elements, extrahiert aus der Ebenen-Auszeichnung (falls angegeben).
description
Typ:string
<description> des Elements, extrahiert aus der Ebenen-Auszeichnung.
id
Typ:string
<id> des Elements, extrahiert aus der Ebenen-Auszeichnung. Wenn keine <id> angegeben wurde, wird eine eindeutige ID für dieses Element generiert.
infoWindowHtml
Typ:string
Der Pop-up-Text des Merkmals, falls festgelegt.
name
Typ:string
<name> des Elements, extrahiert aus der Ebenen-Auszeichnung.
snippet
Typ:string
<Snippet> des Elements, extrahiert aus der Ebenen-Auszeichnung.

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.