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.
Data
Data([options])
Paramètres :
Crée une collection vide avec le DataOptions donné.
add
add([feature])
Paramètres :
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 :
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 :
Valeur renvoyée : boolean
Vérifie si la caractéristique donnée se trouve dans la collection.
forEach
forEach(callback)
Paramètres :
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 :
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 :
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 :
Valeur renvoyée : aucune
Supprime une caractéristique de la collection.
revertStyle
revertStyle([feature])
Paramètres :
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 :
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 :
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 :
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
addfeature
function(event)
Arguments : 
Cet événement est déclenché lorsqu'une entité est ajoutée à la collection.
click
function(event)
Arguments : 
Cet événement est déclenché lorsqu'un utilisateur clique sur la géométrie.
contextmenu
function(event)
Arguments : 
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 : 
Cet événement est déclenché lorsqu'un utilisateur double-clique sur la géométrie.
mousedown
function(event)
Arguments : 
Cet événement est déclenché lorsqu'un clic de souris est effectué sur la géométrie.
mouseout
function(event)
Arguments : 
Cet événement est déclenché lorsque la souris quitte la zone de la géométrie.
mouseover
function(event)
Arguments : 
Cet événement est déclenché lorsque la souris entre dans la zone de la géométrie.
mouseup
function(event)
Arguments : 
Cet événement est déclenché lorsqu'un bouton de la souris est relâché sur la géométrie.
removefeature
function(event)
Arguments : 
Cet événement est déclenché lorsqu'une fonctionnalité est supprimée de la collection.
removeproperty
function(event)
Arguments : 
Cet événement est déclenché lorsqu'une propriété d'une entité est supprimée.
setgeometry
function(event)
Arguments : 
Cet événement est déclenché lorsque la géométrie d'une entité est définie.
setproperty
function(event)
Arguments : 
Cet événement est déclenché lorsqu'une propriété d'une fonctionnalité est définie.
rightclick
function(event)
Arguments : 
Cet événement est déclenché lorsqu'un utilisateur effectue un clic droit sur la géométrie.

Interface Data.DataOptions

Interface google.maps.Data.DataOptions

Objet DataOptions utilisé pour définir les propriétés qu'un développeur peut définir sur un objet Data.
map
Type : Map
Carte sur laquelle afficher les caractéristiques de la collection.
controlPosition optional
Type : ControlPosition optional
Par défaut : ControlPosition.TOP_LEFT
Position des commandes de dessin sur la carte.
controls optional
Type : Array<string> optional
Par défaut : null
Décrit les modes de dessin que l'utilisateur peut sélectionner, dans l'ordre dans lequel ils sont affichés. 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".
drawingMode optional
Type : string optional
Par défaut : null
Mode de dessin actuel de la couche de données donnée. 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".
featureFactory optional
Type : function(Data.Geometry): Data.Feature optional
Lorsque le dessin est activé et qu'un utilisateur dessine une géométrie (point, chaîne de ligne ou polygone), cette fonction est appelée avec cette géométrie et doit renvoyer une entité à ajouter à la couche de données. Si aucun featureFactory n'est fourni, une fonctionnalité sans ID ni propriétés sera créée à partir de cette géométrie. La valeur par défaut est null.
style optional
Style pour tous les éléments de la collection. Pour en savoir plus, consultez la méthode setStyle() ci-dessus.

Data.GeoJsonOptions interface

Interface google.maps.Data.GeoJsonOptions

Paramètres facultatifs pour l'importation de GeoJSON.
idPropertyName optional
Type : string optional
Nom de la propriété Feature à utiliser comme ID de fonctionnalité. Si aucune valeur n'est spécifiée, l'ID de l'entité GeoJSON sera utilisé.

Interface Data.StyleOptions

Interface google.maps.Data.StyleOptions

Ces options spécifient la façon dont un élément doit apparaître lorsqu'il est affiché sur une carte.
animation optional
Type : Animation optional
Animation à lire lorsqu'un repère est ajouté à une carte. Ne s'applique qu'aux géométries de points.
clickable optional
Type : boolean optional
Par défaut : true
Si la valeur est true, le repère reçoit les événements tactiles et de souris.