ol3 - 8a - ol.ObjectEvent

====== OpenLayers3 (2018, part 4) ====== ===== 8. Contrôles et interactions ===== OpenLayers offre un ensemble de fonctionnalités permettant d'interagir avec la carte. Par défaut, les interactions de zoom et pan sont actives mais il en existe d'autres (ol.control). En plus de la gestion événementielle offerte par ces contrôleurs, OpenLayers permet d'enregistrer des écouteurs sur de nombreux événements. Maintenant que les techniques de visualisation cartographique sont maîtrisées, tant côté serveur que client, il s'agit de découvrir comment interagir avec la carte, ses couches et les objets géographiques représentés. ==== A. Gestion événementielle cartographique ==== Cet exemple démontre qu'il est nécessaire qu'un gestionnaire s'occupe spécifiquement d'évenements cartographiques comme ceux en lien avec la vie d'un [[http://openlayers.org/en/v3.20.1/apidoc/ol.Map.html?unstable=true|ol.Map]] ou ceux relatifs à la vie d'une [[http://openlayers.org/en/v3.20.1/apidoc/ol.layer.Vector.html|ol.layer.Vector]], d'une [[http://openlayers.org/en/v3.20.1/apidoc/ol.source.Vector.html|ol.source.Vector]], etc.



    
        ol3 - 8a - ol.ObjectEvent

**TODO** https://www.mediamaps.ch/oltuto/Ex8a.html - Utiliser l'événement //singleclick// pour s'aider à définir un centrage de carte sur un point de votre choix (par exemple les Pierres du Niton) - De nombreuses propriétés des classes OpenLayers sont "observables", comme celles de la classe [[http://openlayers.org/en/v3.19.1/apidoc/ol.View.html|ol.View]]. Ajouter ce qui suit :


// Set listener on change:center (ol.ObjectEvent)
map.getView().on('change:center', function (e) {
    $("#info").html("Center of the map: " + e.target.getCenter());
});

- Adapter l'application pour que soit automatiquement utilisé comme baselayer une couche Bingmaps dès que le niveau de zoom passe à une échelle plus grande que le niveau 6 (à la http://urbangene.heig-vd.ch). - Ajouter une couche vector (que l'on nomme //quakeLayer//) avec les points séismes du point 6A : - Comme au point 6A on souhaite afficher la liste des descriptions des séismes, mais cette fois-ci sans rien imposer à l'utilisateur (keypress), autrement dit que la liste s'affiche automatiquement. Comment faire ? Qu'est-ce qui ne marche justement pas ? - Quel listener de la classe [[http://openlayers.org/en/v3.20.1/apidoc/ol.source.Vector.html?unstable=true|ol.source.Vector]] peut aider ?


// May be we set a listener, but which one ?
quakeLayer.getSource().on("???", function (e) {
    // ???
});

==== B. Interrogation en mode image (GetFeatureInfo) ==== Le gestionnaire d'événements cartographiques va notamment servir à déployer la dernière fonctionnalité de base d'une application de webmapping, celle qui consiste à interroger les objets de la carte. Et d'abord en mode image, c'est-à-dire comment avoir des informations (attributaires) sur l'entité géographique que représente un pixel ("cachée derrière" ce pixel) ? L'application ci-dessous illustre l'interrogation des objets de la carte par le simple clic d'un pixel sur la carte. On enregistre un écouteur sur la map à l'aide de l'habituel [[http://openlayers.org/en/v3.20.1/apidoc/ol.Map.html?unstable=true#on|ol.Map.on]] et afin d'exécuter une action au click sur la map. Cette action utilise alors la méthode [[http://openlayers.org/en/v3.20.1/apidoc/ol.source.ImageWMS.html?unstable=true#getGetFeatureInfoUrl|ol.source.ImageWMS.getGetFeatureInfoUrl]] qui est un générateur de requête WMS GetFeatureInfo, il construit pour nous l'URL qui permet d'interroger le WMS selon contexte de clic et de visualisation. Enfin, la fonction //getFeatureInfo(url)// permet de gérer l'aller/retour avec le serveur WMS avec cette URL précédemment construite.



    
        ol3 - 8b - interaction with WMS GetFeatureInfo operation
        
        

        
    
    
        
        Click on the map to get feature info

**TODO** https://www.mediamaps.ch/oltuto/Ex8b.html - Un serveur WMS peut formatter la réponse de différentes manières (voir la [[https://demo.boundlessgeo.com/geoserver/opengeo/wms?SERVICE=WMS&VERSION=1.0.0&REQUEST=GetCapabilities|configuration du serveur]]). Par exemple, modifier INFO_FORMAT comme suit :


INFO_FORMAT: "application/json"

Que se passe-t-il à l'interrogation de la carte ? Regardez le flux client/serveur ... et exploitez-le pour n'afficher que le nom de pays. - Avec ce format GeoJSON on peut imaginer une interrogation encore plus intéressante, en deux étapes et mettant en évidence visuellement l'entité interrogée. - Ajouter une couche vector :


vectorLayer = new ol.layer.Vector({
    source: new ol.source.Vector()
});
map.addLayer(vectorLayer);

- Modifier le cas **request.done** de la fonction **getFeatureInfo** comme suit :


request.done(function (data) {
    decoder = new ol.format.GeoJSON();
    features = decoder.readFeatures(data);

    if (features.length > 0) {
        vectorLayer.getSource().clear();
        vectorLayer.getSource().addFeatures(features);
        $("#info").html(features[0].get("admin") + " (" + features[0].get("income_grp") + ")");
    }
});

==== C. Interaction avec ol.layer.Vector ==== Après les utilisations possibles pour interagir avec les entités représentées par les services cartographiques, voyons comment interagir directement avec les entités vectors "vivantes" client-side. On utulise pour cela le concept d'[[http://openlayers.org/en/v3.20.1/apidoc/ol.interaction.html?unstable=true|ol.interaction]], notamment [[http://openlayers.org/en/v3.20.1/apidoc/ol.interaction.Select.html?unstable=true|ol.interaction.Select]].



    
        ol3 - 8c - Interaction sur entités vectors
        
        

        
    
    
        
        Select on the map to get feature info

**TODO** https://www.mediamaps.ch/oltuto/Ex8c.html - Quel événement l'[[http://openlayers.org/en/v3.20.1/apidoc/ol.events.condition.html|ol.events.condition]] utiliser pour avoir le comportement type "onmouseover" ? Sans oublier de mettre l'IHM en cohérence (voir [[http://openlayers.org/en/v3.20.1/apidoc/ol.interaction.Select.Event.html#event:select|ol.interaction.Select.Event]] select). - Configurer l'interaction de sorte que l'utilisateur puisse aussi cliquer sur la bulle d'information pour aller à la page des détails du séisme (cf propriété //url//, ex. https://earthquake.usgs.gov/earthquakes/eventpage/nc72722700){{:geoinf16:selectearthquake.png?nolink|}} ==== D. Géoservice d'interrogation personnalisé ==== En mode vector, l'interrogation n'a plus besoin du serveur pour révéler des données attributaires des entités représentées sur la carte. Par contre, comme déjà vu au point B, en mode image, pour que le "pixel révèle" l'information sous-jacente, le serveur doit être sollicité. Le point B fait usage du géoservice standardisé WMS et son opération GetFeatureInfo. Ci-dessous est proposé un géoservice personnalisé qui montre tout le processus d'interrogation, remontant jusque dans la base de données. CARTO (aka cartodb) est utilisé pour ses deux géoservices suivants : * d'abord comme serveur cartographique pour livrer une représentation des cabanes selon des instructions cartographiques pilotées client-side * puis comme serveur d'entités géographiques pour livrer les données attributaires d'une cabane selon un clic sur la carte (et donc des coordonnées) Cette application montre tout le potentiel d'une application de webmapping associé à un géoservice capable de "calculer une géoinformation" (ex. calculer d'un itinéraire, geocoding, geofencing, ...).



    
        ol3 - Ex6a - GeoJSON vector overlay

**TODO** https://www.mediamaps.ch/oltuto/Ex8d.html - Ajouter un champ de saisie pour que l'utilisateur puisse contrôler le rayon de recherche (par défaut radius = 0.01° en dur dans le code ci-dessus) - Plus le rayon est grand, plus la zone de recherche est vaste, trouvant ainsi plusieurs cabanes dans la zone. Adapter la solution pour que les informations de toutes les cabanes de la zone soient affichées (et pas seulement la première cabane)