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 Feature wird ein KmlFeatureData-Objekt bereitgestellt, wenn darauf geklickt wird.

Diese Klasse erweitert MVCObject.

Zugriff durch Aufrufen von const {KmlLayer} = await google.maps.importLibrary("maps"). 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) wiedergibt.
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, der festgelegt wird, 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 die Karte auf null gesetzt ist, wird die Ebene entfernt.
setOptions
setOptions(options)
Parameter:
Rückgabewert:Keine
setUrl
setUrl(url)
Parameter:
  • urlstring
Rückgabewert:Keine
Legt die URL der angezeigten KML-Datei fest.
setZIndex
setZIndex(zIndex)
Parameter:
  • zIndexnumber 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 die KML-Ebene fertig geladen wurde. Jetzt können Sie die Statuseigenschaft lesen, um festzustellen, ob die Ebene erfolgreich geladen wurde.

KmlLayerOptions

google.maps.KmlLayerOptions-Schnittstelle

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

clickable optional
Typ:boolean optional
Standard: true
Wenn 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 diese Option auf true gesetzt oder der Mittelpunkt und die Zoomstufe der Karte nie festgelegt sind, wird die Eingabekarte zentriert und auf den Begrenzungsrahmen des Inhalts der Ebene 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 anzuzeigenden KML-Dokuments.
zIndex optional
Typ:number optional
Der Z-Index der Ebene.

Schnittstelle KmlLayerMetadata

google.maps.KmlLayerMetadata-Schnittstelle

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

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

KmlLayerStatus-Konstanten

google.maps.KmlLayerStatus-Konstanten

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

Zugriff durch Aufrufen 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 es eine ungültige URL oder das Dokument ist nicht öffentlich verfügbar.
DOCUMENT_TOO_LARGE Das Dokument überschreitet die Größ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 Featurelimits 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

google.maps.KmlMouseEvent-Schnittstelle

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.

Schnittstelle KmlFeatureData

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

KmlAuthor

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.