Data

Référence API Google Maps JavaScript version 3.24

API Google Maps JavaScript version 3

Partager ce tutoriel sur les réseaux sociaux
Signaler une erreur dans cet article

Classe Data

classe google.maps.Data

Couche destinée à l'affichage de données géospatiales. Points, ligne et des polygones peuvent être affichés.

Chaque carte possède un objet Data par défaut, donc la plupart du temps il n'est pas nécessaire d'en construire un. Par exemple :

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

L'objet Data est un ensemble de Data.Feature.

Cette classe hérite de la class MVCObject.

Constructeur
Evénement
Méthode
Constructeur Data
ConstructeurDescription
Data(
     options?:Data.DataOptions
)

Crée une collection vide, avec l'objet Data.DataOptions donné.

Evénement Data
EvénementArgumentsDescription
addfeatureArguments : Data.AddFeatureEvent

Cet événement est déclenché quand un élément est ajouté à la collection.

clickArguments : Data.MouseEvent

Cet événement est déclenché pour un click sur la géométrie.

dblclickArguments : Data.MouseEvent

Cet événement est déclenché pour un double-click sur la géométrie.

mousedownArguments : Data.MouseEvent

Cet événement est déclenché pour une mousedown sur la géométrie.

mouseoutArguments : Data.MouseEvent

Cet événement est déclenché lorsque la souris quitte la zone de la géométrie.

mouseoverArguments : Data.MouseEvent

Cet événement est déclenché lorsque la souris pénètre dans la zone de la géométrie.

mouseupArguments : Data.MouseEvent

Cet événement est déclenché pour une mouseup sur la géométrie.

removefeatureArguments : Data.RemoveFeatureEvent

Cet événement est déclenché quand un élément est supprimé de la collection.

removepropertyArguments : Data.RemovePropertyEvent

Cet événement est déclenché lorsque la propriété d'un élément est supprimé.

rightclickArguments : Data.MouseEvent

Cet événement est déclenché pour un clic-droit rightclick sur ​​la géométrie.

setgeometryArguments : Data.SetGeometryEvent

Cet événement est déclenché lorsqu'un élément de géométrie est défini.

setpropertyArguments : Data.SetPropertyEvent

Cet événement est déclenché lorsque la propriété d'un élément est définie.

Méthode Data
MéthodeValeur RetournéeDescription
Valeur retournée : 
add(
     feature:Data.Feature|Data.FeatureOptions
)
Valeur retournée : Data.Feature

Ajoute un élément à la collection et retourne la fonctionnalité ajoutée.

Si la fonction a un ID, il remplacera tout élément existant dans la collection avec le même ID. Si aucune caractéristique n’est donnée, une nouvelle caractéristique sera créée avec une propriété geométry  null  et aucune autre propriété. Si Data.FeatureOptions sont données, une nouvelle caractéristique sera créée avec les propriétés spécifiées.

Notez que les ID 1234 et '1234' sont équivalentes. L'ajout d’une caractéristique ayant pour ID 1234 remplacera la fonctionnalité avec l’ID '1234' et vice versa.

addGeoJson(
    geoJson:Object,
    options?:Data.GeoJsonOptions
)
Valeur retournée :  Array <Data.Feature>

Ajoute des caractéristiques GeoJSON à la collection.
Transmettre à cette méthode un JSON analysé.
Les caractéristiques importées sont retournées.
Lève une exception si le GeoJSON n'a pas pu être importé.

contains(
    feature:Data.Feature
)
Valeur retournée :  boolean 

Vérifie si la caractéristique donnée est présente dans la collection.

forEach(
    callback:function(Data.Feature)
)
Valeur retournée :  None 

Appel à plusieurs reprises la fonction donnée, passant une caractéristique de la collection à la fonction lors de chaque appel.
L'ordre d'itération à travers les caractéristiques n'est pas défini.

getControlPosition()Valeur retournée : ControlPosition

Retourne la position des commandes de dessin sur la carte.

getControls()Valeur retournée :  Array < string >

Retourne les modes de dessin disponibles que l’utilisateur peut sélectionner, dans l’ordre dans lequel ils sont affichés. Ceci n’inclut pas le mode de dessin  null , qui est ajouté  par défaut . Les modes de dessin possibles sont "Point", "LineString" ou "Polygon".

getDrawingMode()Valeur retournée :  string 

Retourne le mode de dessin actuel pour la couche de données donnée. Un mode de dessin  null  signifie que l’utilisateur peut interagir avec la carte comme d’habitude et que les clicks ne permettront pas de dessiner quoique ce soit. Les modes possibles de dessin sont  null , "Point", "LineString" ou "Polygon".

getFeatureById(
    id: number | string 
)
Valeur retournée : Data.Feature| undefined 

Retourne la caractéristique avec l'ID donné, si elle existe dans la collection.
Sinon, retourne la valeur undefined.

Notez que les ID 1234 et '1234' sont équivalents. L'un ou l’autre peut être utilisé pour rechercher la même caractéristique.

getMap()Valeur retournée : Map

Retourne la carte sur laquelle les caractéristiques sont affichées.

getStyle()Valeur retournée : Data.StylingFunction|Data.StyleOptions

Retourne le style pour toutes les caractéristiques de la collection.

loadGeoJson(
    url: string ,
    options?:Data.GeoJsonOptions,
    callback?:function( Array <Data.Feature>)
)
Valeur retournée :  None 

Télécharge un GeoJSON à partir d'une URL et ajoute les caractéristiques à la collection.

overrideStyle(
    feature:Data.Feature,
    style:Data.StyleOptions
)
Valeur retournée :  None 

Modifie le style d'une caractéristique.
Ces modifications sont appliquées sur le dessus du style spécifié par Data.setStyle().
Les propriétés de style définies à  null  retrouvent la valeur spécifiée via Data.setStyle().

remove(
    feature:Data.Feature
)
Valeur retournée :  None 

Supprime une caractéristique de la collection.

revertStyle(
    feature?:Data.Feature
)
Valeur retournée :  None 

Supprime l'effet du précédent appel Data.overrideStyle().
Le style de la caractéristique donnée revient au style spécifié par Data.setStyle().
Si aucune caractéristique n'est donnée, toutes les caractéristiques voient leurs styles repasser à leur précédent état.

setControlPosition(
    controlPosition:ControlPosition
)
Valeur retournée :  None 

Définit la position des contrôles de dessin sur la carte.

setControls(
    controls: Array < string >
)
Valeur retournée :  None 

Définit les modes de dessin disponibles 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 non affichées. Les modes de dessin possibles sont "Point", "LineString" ou "Polygon".

setDrawingMode(
    drawingMode: string 
)
Valeur retournée :  None 

Définit le mode de dessin actuel pour la couche de données donnée. Un mode de dessin sur  null  signifie que l’utilisateur peut interagir avec la carte comme d’habitude et que les clicks ne permettent plus de dessiner quoi que ce soit. Les modes possibles de dessin sont " null ", "Point", "LineString" ou "Polygon".

setMap(
    map:Map
)
Valeur retournée :  None 

Restitue les caractéristiques sur la carte spécifiée.
Si la carte est définie sur  null , les éléments seront supprimés de la carte.

setStyle(
    style:Data.StylingFunction|Data.StyleOptions
)
Valeur retournée :  None 

Définit le style de toutes les caractéristiques de la collection.
Les styles spécifiés sur une base par fonction par Data.overrideStyle() continuent de s'appliquer.

Passer soit un objet avec les options de style souhaitées, ou une fonction qui calcule le style pour chaque caractéristique.
La fonction sera appelée à chaque fois que les propriétés d'une caractéristique seront mises à jour.

toGeoJson(
    callback:function(Object)
)
Valeur retournée :  None 

Exporte les caractéristiques de la collection vers un objet GeoJSON.