Diese Seite wurde von der Cloud Translation API übersetzt.

Data

Datenklasse

google.maps.Data Klasse

Eine Ebene zum Anzeigen von raumbezogenen Daten. Punkte, Linienstrings und Polygone können angezeigt werden.

Jedes Map hat standardmäßig ein Data-Objekt. Daher ist es in den meisten Fällen nicht erforderlich, eines zu erstellen. Beispiel:

 var myMap = new google.maps.Map(...);
 myMap.data.addGeoJson(...);
 myMap.data.setStyle(...);

: Das Data-Objekt ist eine Sammlung von Features.

Diese Klasse erweitert MVCObject.

Zugriff durch Anrufen von const {Data} = await google.maps.importLibrary("maps").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Konstruktor
`Data`	`Data([options])` Parameter: `options`: `Data.DataOptions optional` Erstellt eine leere Sammlung mit dem angegebenen `DataOptions`.

Methoden
`add`	`add([feature])` Parameter: `feature`: `Data.Feature\|Data.FeatureOptions optional` Rückgabewert:`Data.Feature` Fügt der Sammlung ein Feature hinzu und gibt das hinzugefügte Feature zurück. Wenn das Feature eine ID hat, wird jedes vorhandene Feature in der Sammlung mit derselben ID ersetzt. Wenn kein Feature angegeben ist, wird ein neues Feature mit Nullgeometrie und ohne Eigenschaften erstellt. Wenn `FeatureOptions` angegeben sind, wird ein neues Attribut mit den angegebenen Eigenschaften erstellt. Die IDs `1234` und `'1234'` sind gleichwertig. Wenn Sie ein Attribut mit der ID `1234` hinzufügen, wird ein Attribut mit der ID `'1234'` ersetzt und umgekehrt.
`addGeoJson`	`addGeoJson(geoJson[, options])` Parameter: `geoJson`: `Object` `options`: `Data.GeoJsonOptions optional` Rückgabewert:`Array<Data.Feature>` Fügt der Sammlung GeoJSON-Features hinzu. Geben Sie für diese Methode ein geparstes JSON an. Die importierten Funktionen werden zurückgegeben. Löst eine Ausnahme aus, wenn das GeoJSON nicht importiert werden konnte.
`contains`	`contains(feature)` Parameter: `feature`: `Data.Feature` Rückgabewert:`boolean` Prüft, ob das angegebene Attribut in der Sammlung enthalten ist.
`forEach`	`forEach(callback)` Parameter: `callback`: `function(Data.Feature): void` Rückgabewert:Keiner Ruft die angegebene Funktion wiederholt auf und übergibt bei jedem Aufruf ein Element in der Sammlung an die Funktion. Die Reihenfolge der Iteration durch die Funktionen ist nicht definiert.
`getControlPosition`	`getControlPosition()` Parameter:Keine Rückgabewert:`ControlPosition` Gibt die Position der Zeichensteuerelemente auf der Karte zurück.
`getControls`	`getControls()` Parameter:Keine Rückgabewert:`Array<string>` Gibt die Zeichenmodi zurück, die der Nutzer auswählen kann, in der Reihenfolge, in der sie angezeigt werden. Der Zeichenmodus `null` ist nicht enthalten, da er standardmäßig hinzugefügt wird. Mögliche Zeichenmodi sind `"Point"`, `"LineString"` und `"Polygon"`.
`getDrawingMode`	`getDrawingMode()` Parameter:Keine Rückgabewert:`string\|null` Gibt den aktuellen Zeichenmodus der angegebenen Datenschicht zurück. Bei einem Zeichenmodus von `null` kann der Nutzer wie gewohnt mit der Karte interagieren. Durch Klicken wird nichts gezeichnet. Mögliche Zeichenmodi sind `null`, `"Point"`, `"LineString"` oder `"Polygon"`.
`getFeatureById`	`getFeatureById(id)` Parameter: `id`: `number\|string` Rückgabewert:`Data.Feature\|undefined` Gibt das Element mit der angegebenen ID zurück, sofern es in der Sammlung vorhanden ist. Andernfalls wird `undefined` zurückgegeben. Die IDs `1234` und `'1234'` sind gleichwertig. Beide können verwendet werden, um dieselbe Funktion zu suchen.
`getMap`	`getMap()` Parameter:Keine Rückgabewert:`Map` Gibt die Karte zurück, auf der die Elemente angezeigt werden.
`getStyle`	`getStyle()` Parameter:Keine Rückgabewert:`Data.StylingFunction\|Data.StyleOptions` Ruft den Stil für alle Elemente in der Sammlung ab.
`loadGeoJson`	`loadGeoJson(url[, options, callback])` Parameter: `url`: `string` `options`: `Data.GeoJsonOptions optional` `callback`: `function(Array<Data.Feature>): void optional` Rückgabewert:Keiner Lädt GeoJSON aus einer URL und fügt die Elemente der Sammlung hinzu. HINWEIS: Das GeoJSON wird mit XHR abgerufen und funktioniert möglicherweise nicht domainübergreifend. Wenn Sie Probleme haben, empfehlen wir, das GeoJSON mit einer AJAX-Bibliothek Ihrer Wahl abzurufen und dann `addGeoJson()` aufzurufen.
`overrideStyle`	`overrideStyle(feature, style)` Parameter: `feature`: `Data.Feature` `style`: `Data.StyleOptions` Rückgabewert:Keiner Ändert den Stil eines Features. Diese Änderungen werden zusätzlich zum Stil angewendet, der durch `setStyle()` angegeben wird. Stileigenschaften, die auf `null` gesetzt sind, werden auf den über `setStyle()` angegebenen Wert zurückgesetzt.
`remove`	`remove(feature)` Parameter: `feature`: `Data.Feature` Rückgabewert:Keiner Entfernt ein Feature aus der Sammlung.
`revertStyle`	`revertStyle([feature])` Parameter: `feature`: `Data.Feature optional` Rückgabewert:Keiner Entfernt die Wirkung vorheriger `overrideStyle()`-Aufrufe. Der Stil des angegebenen Elements wird auf den Stil zurückgesetzt, der durch `setStyle()` angegeben ist. Wenn kein Attribut angegeben ist, wird der Stil aller Attribute zurückgesetzt.
`setControlPosition`	`setControlPosition(controlPosition)` Parameter: `controlPosition`: `ControlPosition` Rückgabewert:Keiner Legt die Position der Zeichensteuerelemente auf der Karte fest.
`setControls`	`setControls(controls)` Parameter: `controls`: `Array<string>` Rückgabewert:Keiner Legt fest, welche Zeichenmodi für den Nutzer zur Auswahl stehen, und zwar in der Reihenfolge, in der sie angezeigt werden. Der `null`-Zeichenmodus, der standardmäßig hinzugefügt wird, sollte nicht enthalten sein. Wenn `null`, sind die Zeichensteuerelemente deaktiviert und werden nicht angezeigt. Mögliche Zeichenmodi sind `"Point"`, `"LineString"` und `"Polygon"`.
`setDrawingMode`	`setDrawingMode(drawingMode)` Parameter: `drawingMode`: `string optional` Rückgabewert:Keiner Legt den aktuellen Zeichenmodus der angegebenen Datenebene fest. Bei einem Zeichenmodus von `null` kann der Nutzer wie gewohnt mit der Karte interagieren. Durch Klicken wird nichts gezeichnet. Mögliche Zeichenmodi sind `null`, `"Point"`, `"LineString"` oder `"Polygon"`.
`setMap`	`setMap(map)` Parameter: `map`: `Map` Rückgabewert:Keiner Rendert die Elemente auf der angegebenen Karte. Wenn die Karte auf `null` festgelegt ist, werden die Elemente von der Karte entfernt.
`setStyle`	`setStyle(style)` Parameter: `style`: `Data.StylingFunction\|Data.StyleOptions` Rückgabewert:Keiner Legt den Stil für alle Elemente in der Sammlung fest. Stile, die über `overrideStyle()` für einzelne Elemente angegeben werden, werden weiterhin angewendet. Übergeben Sie entweder ein Objekt mit den gewünschten Stiloptionen oder eine Funktion, die den Stil für jedes Element berechnet. Die Funktion wird jedes Mal aufgerufen, wenn die Eigenschaften eines Elements aktualisiert werden.
`toGeoJson`	`toGeoJson(callback)` Parameter: `callback`: `function(Object): void` Rückgabewert:Keiner Exportiert die Features in der Sammlung in ein GeoJSON-Objekt.
Geerbt:`addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Ereignisse
`addfeature`	`function(event)` Argumente: `event`: `Data.AddFeatureEvent` Dieses Ereignis wird ausgelöst, wenn der Sammlung ein Element hinzugefügt wird.
`click`	`function(event)` Argumente: `event`: `Data.MouseEvent` Dieses Ereignis wird bei einem Klick auf die Geometrie ausgelöst.
`contextmenu`	`function(event)` Argumente: `event`: `Data.MouseEvent` Dieses Ereignis wird ausgelöst, wenn das DOM-Ereignis „contextmenu“ für die Geometrie ausgelöst wird.
`dblclick`	`function(event)` Argumente: `event`: `Data.MouseEvent` Dieses Ereignis wird bei einem Doppelklick auf die Geometrie ausgelöst.
`mousedown`	`function(event)` Argumente: `event`: `Data.MouseEvent` Dieses Ereignis wird bei einem „mousedown“-Ereignis für die Geometrie ausgelöst.
`mouseout`	`function(event)` Argumente: `event`: `Data.MouseEvent` Dieses Ereignis wird ausgelöst, wenn die Maus den Bereich der Geometrie verlässt.
`mouseover`	`function(event)` Argumente: `event`: `Data.MouseEvent` Dieses Ereignis wird ausgelöst, wenn die Maus in den Bereich der Geometrie eintritt.
`mouseup`	`function(event)` Argumente: `event`: `Data.MouseEvent` Dieses Ereignis wird bei einem „mouseup“-Ereignis für die Geometrie ausgelöst.
`removefeature`	`function(event)` Argumente: `event`: `Data.RemoveFeatureEvent` Dieses Ereignis wird ausgelöst, wenn ein Element aus der Sammlung entfernt wird.
`removeproperty`	`function(event)` Argumente: `event`: `Data.RemovePropertyEvent` Dieses Ereignis wird ausgelöst, wenn eine Eigenschaft eines Features entfernt wird.
`setgeometry`	`function(event)` Argumente: `event`: `Data.SetGeometryEvent` Dieses Ereignis wird ausgelöst, wenn die Geometrie eines Features festgelegt wird.
`setproperty`	`function(event)` Argumente: `event`: `Data.SetPropertyEvent` Dieses Ereignis wird ausgelöst, wenn eine Property eines Features festgelegt wird.
`rightclick`	Verworfen:Verwenden Sie stattdessen das Ereignis `Data.contextmenu`, um Nutzungsmuster wie Strg+Klick unter macOS zu unterstützen. `function(event)` Argumente: `event`: `Data.MouseEvent` Dieses Ereignis wird ausgelöst, wenn mit der rechten Maustaste auf die Geometrie geklickt wird.

Data.DataOptions-Schnittstelle

google.maps.Data.DataOptions-Schnittstelle

DataOptions-Objekt zum Definieren der Eigenschaften, die ein Entwickler für ein Data-Objekt festlegen kann.

Attribute
`map`	Typ:`Map` Karte, auf der die Elemente der Sammlung angezeigt werden sollen.
`controlPosition optional`	Typ:`ControlPosition optional` Standard:`ControlPosition.TOP_LEFT` Die Position der Zeichensteuerelemente auf der Karte.
`controls optional`	Typ:`Array<string> optional` Standard:`null` Beschreibt, welche Zeichenmodi dem Nutzer zur Auswahl stehen, in der Reihenfolge, in der sie angezeigt werden. Der `null`-Zeichenmodus, der standardmäßig hinzugefügt wird, sollte nicht enthalten sein. Wenn `null`, sind die Zeichensteuerelemente deaktiviert und werden nicht angezeigt. Mögliche Zeichenmodi sind `"Point"`, `"LineString"` und `"Polygon"`.
`drawingMode optional`	Typ:`string optional` Standard:`null` Der aktuelle Zeichenmodus der angegebenen Datenschicht. Bei einem Zeichenmodus von `null` kann der Nutzer wie gewohnt mit der Karte interagieren. Durch Klicken wird nichts gezeichnet. Mögliche Zeichenmodi sind `null`, `"Point"`, `"LineString"` oder `"Polygon"`.
`featureFactory optional`	Typ:`function(Data.Geometry): Data.Feature optional` Wenn das Zeichnen aktiviert ist und ein Nutzer eine Geometrie (einen Punkt, eine Linie oder ein Polygon) zeichnet, wird diese Funktion mit der entsprechenden Geometrie aufgerufen. Sie sollte ein Feature zurückgeben, das der Datenschicht hinzugefügt werden soll. Wenn kein „featureFactory“ angegeben wird, wird stattdessen ein Feature ohne ID und ohne Attribute aus dieser Geometrie erstellt. Die Standardeinstellung ist `null`.
`style optional`	Typ:`Data.StylingFunction\|Data.StyleOptions optional` Stil für alle Elemente in der Sammlung. Weitere Informationen finden Sie oben im Abschnitt zur `setStyle()`-Methode.

Data.GeoJsonOptions-Schnittstelle

google.maps.Data.GeoJsonOptions-Schnittstelle

Optionale Parameter für den Import von GeoJSON-Dateien.

Attribute
`idPropertyName optional`	Typ:`string optional` Der Name der Feature-Property, die als Feature-ID verwendet werden soll. Wenn nicht angegeben, wird die GeoJSON-Feature-ID verwendet.

Data.StyleOptions-Schnittstelle

google.maps.Data.StyleOptions-Schnittstelle

Mit diesen Optionen wird festgelegt, wie ein Feature auf einer Karte dargestellt werden soll.

Attribute
`animation optional`	Typ:`Animation optional` Die Animation, die abgespielt werden soll, wenn eine Markierung auf einer Karte hinzugefügt wird. Gilt nur für Punktgeometrien.
`clickable optional`	Typ:`boolean optional` Standard:`true` Wenn `true` festgelegt ist, empfängt die Markierung Maus- und Touch-Ereignisse.
`cursor optional`	Typ:`string optional` Beim Hovern wird der Mauscursor angezeigt. Gilt nur für Punktgeometrien.
`draggable optional`	Typ:`boolean optional` Standard:`false` Wenn `true`, kann das Objekt auf der Karte verschoben werden und die Geometrie des zugrunde liegenden Elements wird aktualisiert.
`editable optional`	Typ:`boolean optional` Standard:`false` Wenn `true` gilt, kann das Objekt bearbeitet werden, indem Sie Kontrollpunkte ziehen. Die Geometrie des zugrunde liegenden Features wird dann aktualisiert. Gilt nur für LineString- und Polygon-Geometrien.
`fillColor optional`	Typ:`string optional` Die Füllfarbe. Alle CSS3-Farben werden unterstützt, mit Ausnahme von Farben mit erweiterten Namen. Gilt nur für Polygongeometrien.
`fillOpacity optional`	Typ:`number optional` Die Deckkraft der Füllung zwischen 0,0 und 1,0. Gilt nur für Polygongeometrien.
`icon optional`	Typ:`string\|Icon\|Symbol optional` Symbol für den Vordergrund. Wenn ein String angegeben wird, wird er so behandelt, als wäre er ein `Icon` mit dem String als `url`. Gilt nur für Punktgeometrien.
`icons optional`	Typ:`Array<IconSequence> optional` Die Symbole, die entlang einer Polylinie gerendert werden sollen. Gilt nur für Liniengeometrien.
`label optional`	Typ:`string\|MarkerLabel optional` Fügt der Markierung ein Label hinzu. Das Label kann entweder ein String oder ein `MarkerLabel`-Objekt sein. Gilt nur für Punktgeometrien.
`opacity optional`	Typ:`number optional` Die Deckkraft des Markers zwischen 0,0 und 1,0. Gilt nur für Punktgeometrien.
`shape optional`	Typ:`MarkerShape optional` Definiert die Bildkarte, die für die Trefferermittlung verwendet wird. Gilt nur für Punktgeometrien.
`strokeColor optional`	Typ:`string optional` Die Strichfarbe. Alle CSS3-Farben werden unterstützt, mit Ausnahme von Farben mit erweiterten Namen. Gilt nur für Linien- und Polygongeometrien.
`strokeOpacity optional`	Typ:`number optional` Die Deckkraft der Linie zwischen 0,0 und 1,0. Gilt nur für Linien- und Polygongeometrien.
`strokeWeight optional`	Typ:`number optional` Die Linienstärke in Pixeln. Gilt nur für Linien- und Polygongeometrien.
`title optional`	Typ:`string optional` Rollover-Text. Gilt nur für Punktgeometrien.
`visible optional`	Typ:`boolean optional` Standard:`true` Gibt an, ob das Feature sichtbar ist.
`zIndex optional`	Typ:`number optional` Alle Elemente werden auf der Grundlage ihres zIndex-Werts in absteigender Reihenfolge auf der Karte angezeigt. Markierungen werden immer vor Linienstrings und Polygonen angezeigt.

Data.StylingFunction typedef

google.maps.Data.StylingFunction typedef

Eine Funktion, die das Erscheinungsbild eines Features berechnet.

Die Methode Data.setStyle() kann eine Formatierungsfunktion akzeptieren. Verwenden Sie diese Option, wenn Funktionen je nach ihren Eigenschaften unterschiedlich dargestellt werden sollen. Weitere Informationen zu den Formatierungsfunktionen finden Sie im Entwicklerhandbuch.

function(Data.Feature): Data.StyleOptions

Data.Feature-Klasse

google.maps.Data.Feature Klasse

Ein Feature hat eine Geometrie, eine ID und eine Reihe von Attributen.

Zugriff durch Anrufen von const {Data} = await google.maps.importLibrary("maps").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Konstruktor
`Data.Feature`	`Data.Feature([options])` Parameter: `options`: `Data.FeatureOptions optional` Erstellt ein Feature mit den angegebenen Optionen.

Methoden
`forEachProperty`	`forEachProperty(callback)` Parameter: `callback`: `function(, string): void` Rückgabewert*:Keiner Ruft die angegebene Funktion wiederholt auf und übergibt bei jedem Aufruf einen Eigenschaftswert und einen Namen. Die Reihenfolge der Iteration durch die Eigenschaften ist nicht definiert.
`getGeometry`	`getGeometry()` Parameter:Keine Rückgabewert:`Data.Geometry` Gibt die Geometrie des Elements zurück.
`getId`	`getId()` Parameter:Keine Rückgabewert:`number\|string\|undefined` Gibt die Feature-ID zurück.

Data Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Datenklasse

Konstruktor

Methoden

Ereignisse

Data.DataOptions-Schnittstelle

Attribute

Data.GeoJsonOptions-Schnittstelle

Attribute

Data.StyleOptions-Schnittstelle

Attribute

Data.StylingFunction typedef

Data.Feature-Klasse

Konstruktor

Methoden

Data