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.
Konstruktor | |
---|---|
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. |
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 Ruft den Status der Ebene ab, der festgelegt wird, nachdem das angeforderte Dokument geladen wurde. |
getUrl |
getUrl() Parameter:Keine
Rückgabewert:
string URLRuft die URL der angezeigten KML-Datei ab. |
getZIndex |
getZIndex() Parameter:Keine
Rückgabewert:
number der Z-IndexRuft 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:
Rückgabewert:Keine
Legt die URL der angezeigten KML-Datei fest. |
setZIndex |
setZIndex(zIndex) Parameter:
Rückgabewert:Keine
Legt den Z-Index der KML-Ebene fest. |
Übernommen:
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 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.
Attribute | |
---|---|
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.
Attribute | |
---|---|
author |
Typ:
KmlAuthor 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.
Konstanten | |
---|---|
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.
Attribute | |
---|---|
featureData |
Typ:
KmlFeatureData 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.
Attribute | |
---|---|
author |
Typ:
KmlAuthor 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.
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. |