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.
Konstruktor | |
---|---|
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. |
Methoden | |
---|---|
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 -URLGibt 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:
Rückgabewert:Keiner
Legt die URL der anzuzeigenden KML-Datei fest. |
setZIndex |
setZIndex(zIndex) Parameter:
Rückgabewert:Keiner
Legt den Z-Index der KML-Ebene fest. |
Geerbt:addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Ereignisse | |
---|---|
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.
Attribute | |
---|---|
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.
Attribute | |
---|---|
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.
Konstanten | |
---|---|
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.
Attribute | |
---|---|
featureData |
Typ:
KmlFeatureData 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.
Attribute | |
---|---|
author |
Typ:
KmlAuthor 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.
Attribute | |
---|---|
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. |