Cette page a été traduite par l'API Cloud Translation.

Data

Classe Data

Classe google.maps.Data

Calque permettant d'afficher des données géospatiales. Les points, les polylignes et les polygones peuvent être affichés.

Chaque Map possède un objet Data par défaut. La plupart du temps, il n'est donc pas nécessaire d'en construire un. Exemple :

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

: l'objet Data est une collection de Features.

Cette classe étend MVCObject.

Accédez-y en appelant le const {Data} = await google.maps.importLibrary("maps").
Consultez Bibliothèques de l'API Maps JavaScript.

Constructeur
`Data`	`Data([options])` Paramètres : `options` : `Data.DataOptions optional` Crée une collection vide avec le `DataOptions` donné.

Méthodes
`add`	`add([feature])` Paramètres : `feature` : `Data.Feature\|Data.FeatureOptions optional` Valeur renvoyée : `Data.Feature` Ajoute un élément à la collection et renvoie l'élément ajouté. Si la fonctionnalité possède un ID, elle remplacera toute fonctionnalité existante dans la collection portant le même ID. Si aucune entité n'est indiquée, une entité est créée avec une géométrie nulle et sans propriétés. Si des `FeatureOptions` sont fournis, une fonctionnalité est créée avec les propriétés spécifiées. Notez que les ID `1234` et `'1234'` sont équivalents. L'ajout d'une fonctionnalité avec l'ID `1234` remplacera une fonctionnalité avec l'ID `'1234'`, et inversement.
`addGeoJson`	`addGeoJson(geoJson[, options])` Paramètres : `geoJson` : `Object` `options` : `Data.GeoJsonOptions optional` Valeur renvoyée : `Array<Data.Feature>` Ajoute des fonctionnalités GeoJSON à la collection. Fournissez un fichier JSON analysé à cette méthode. Les caractéristiques importées sont renvoyées. Génère une exception si le GeoJSON n'a pas pu être importé.
`contains`	`contains(feature)` Paramètres : `feature` : `Data.Feature` Valeur renvoyée : `boolean` Vérifie si la caractéristique donnée se trouve dans la collection.
`forEach`	`forEach(callback)` Paramètres : `callback` : `function(Data.Feature): void` Valeur renvoyée : aucune Appelle la fonction donnée à plusieurs reprises, en transmettant un élément de la collection à la fonction à chaque appel. L'ordre d'itération des caractéristiques n'est pas défini.
`getControlPosition`	`getControlPosition()` Paramètres : aucun Valeur renvoyée : `ControlPosition` Renvoie la position des commandes de dessin sur la carte.
`getControls`	`getControls()` Paramètres : aucun Valeur renvoyée : `Array<string>` Renvoie les modes de dessin disponibles pour l'utilisateur, dans l'ordre dans lequel ils sont affichés. Cela n'inclut pas le mode dessin `null`, qui est ajouté par défaut. Les modes de dessin possibles sont `"Point"`, `"LineString"` ou `"Polygon"`.
`getDrawingMode`	`getDrawingMode()` Paramètres : aucun Valeur renvoyée : `string\|null` Renvoie le mode de dessin actuel du calque de données donné. Un mode de dessin `null` signifie que l'utilisateur peut interagir avec la carte normalement et que les clics ne dessinent rien. Les modes de dessin possibles sont `null`, `"Point"`, `"LineString"` ou `"Polygon"`.
`getFeatureById`	`getFeatureById(id)` Paramètres : `id` : `number\|string` Valeur renvoyée : `Data.Feature\|undefined` Renvoie la fonctionnalité avec l'ID spécifié, si elle existe dans la collection. Sinon, renvoie `undefined`. Notez que les ID `1234` et `'1234'` sont équivalents. Vous pouvez utiliser l'une ou l'autre pour rechercher la même fonctionnalité.
`getMap`	`getMap()` Paramètres : aucun Valeur renvoyée : `Map` Renvoie la carte sur laquelle les entités sont affichées.
`getStyle`	`getStyle()` Paramètres : aucun Valeur renvoyée : `Data.StylingFunction\|Data.StyleOptions` Récupère le style de tous les éléments de la collection.
`loadGeoJson`	`loadGeoJson(url[, options, callback])` Paramètres : `url` : `string` `options` : `Data.GeoJsonOptions optional` `callback` : `function(Array<Data.Feature>): void optional` Valeur renvoyée : aucune Charge le code GeoJSON à partir d'une URL et ajoute les caractéristiques à la collection. REMARQUE : Le GeoJSON est récupéré à l'aide de XHR et peut ne pas fonctionner sur plusieurs domaines. En cas de problème, nous vous recommandons de récupérer le GeoJSON à l'aide de la bibliothèque AJAX de votre choix, puis d'appeler `addGeoJson()`.
`overrideStyle`	`overrideStyle(feature, style)` Paramètres : `feature` : `Data.Feature` `style` : `Data.StyleOptions` Valeur renvoyée : aucune Modifie le style d'une entité. Ces modifications sont appliquées en plus du style spécifié par `setStyle()`. Les propriétés de style définies sur `null` reviennent à la valeur spécifiée via `setStyle()`.
`remove`	`remove(feature)` Paramètres : `feature` : `Data.Feature` Valeur renvoyée : aucune Supprime une caractéristique de la collection.
`revertStyle`	`revertStyle([feature])` Paramètres : `feature` : `Data.Feature optional` Valeur renvoyée : aucune Supprime l'effet des appels `overrideStyle()` précédents. Le style de l'élément donné revient à celui spécifié par `setStyle()`. Si aucun élément n'est indiqué, le style de tous les éléments est rétabli.
`setControlPosition`	`setControlPosition(controlPosition)` Paramètres : `controlPosition` : `ControlPosition` Valeur renvoyée : aucune Définit la position des commandes de dessin sur la carte.
`setControls`	`setControls(controls)` Paramètres : `controls` : `Array<string>` Valeur renvoyée : aucune Définit les modes de dessin que l'utilisateur peut sélectionner, dans l'ordre dans lequel ils s'affichent. Cela ne doit pas inclure le mode dessin `null`, qui est ajouté par défaut. Si la valeur est `null`, les commandes de dessin sont désactivées et ne s'affichent pas. Les modes de dessin possibles sont `"Point"`, `"LineString"` ou `"Polygon"`.
`setDrawingMode`	`setDrawingMode(drawingMode)` Paramètres : `drawingMode` : `string optional` Valeur renvoyée : aucune Définit le mode de dessin actuel du calque de données donné. Un mode de dessin `null` signifie que l'utilisateur peut interagir avec la carte normalement et que les clics ne dessinent rien. Les modes de dessin possibles sont `null`, `"Point"`, `"LineString"` ou `"Polygon"`.
`setMap`	`setMap(map)` Paramètres : `map` : `Map` Valeur renvoyée : aucune Affiche les caractéristiques sur la carte spécifiée. Si la carte est définie sur `null`, les fonctionnalités seront supprimées de la carte.
`setStyle`	`setStyle(style)` Paramètres : `style` : `Data.StylingFunction\|Data.StyleOptions` Valeur renvoyée : aucune Définit le style de tous les éléments de la collection. Les styles spécifiés par fonctionnalité via `overrideStyle()` continuent de s'appliquer. Transmettez un objet avec les options de style souhaitées ou une fonction qui calcule le style de chaque élément géographique. La fonction est appelée chaque fois que les propriétés d'un élément sont mises à jour.
`toGeoJson`	`toGeoJson(callback)` Paramètres : `callback` : `function(Object): void` Valeur renvoyée : aucune Exporte les entités de la collection vers un objet GeoJSON.
Hérité : `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Événements
`addfeature`	`function(event)` Arguments : `event` : `Data.AddFeatureEvent` Cet événement est déclenché lorsqu'une entité est ajoutée à la collection.
`click`	`function(event)` Arguments : `event` : `Data.MouseEvent` Cet événement est déclenché lorsqu'un utilisateur clique sur la géométrie.
`contextmenu`	`function(event)` Arguments : `event` : `Data.MouseEvent` Cet événement est déclenché lorsque l'événement contextmenu du DOM est déclenché sur la géométrie.
`dblclick`	`function(event)` Arguments : `event` : `Data.MouseEvent` Cet événement est déclenché lorsqu'un utilisateur double-clique sur la géométrie.
`mousedown`	`function(event)` Arguments : `event` : `Data.MouseEvent` Cet événement est déclenché lorsqu'un clic de souris est effectué sur la géométrie.
`mouseout`	`function(event)` Arguments : `event` : `Data.MouseEvent` Cet événement est déclenché lorsque la souris quitte la zone de la géométrie.
`mouseover`	`function(event)` Arguments : `event` : `Data.MouseEvent` Cet événement est déclenché lorsque la souris entre dans la zone de la géométrie.
`mouseup`	`function(event)` Arguments : `event` : `Data.MouseEvent` Cet événement est déclenché lorsqu'un bouton de la souris est relâché sur la géométrie.
`removefeature`	`function(event)` Arguments : `event` : `Data.RemoveFeatureEvent` Cet événement est déclenché lorsqu'une fonctionnalité est supprimée de la collection.
`removeproperty`	`function(event)` Arguments : `event` : `Data.RemovePropertyEvent` Cet événement est déclenché lorsqu'une propriété d'une entité est supprimée.

Data Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Classe Data

Constructeur

Méthodes

Événements

Data