Les APIS du Géoportail

Les APIS du Géoportail
ign.fr
Plan
I.
II.
III.
IV.
V.
VI.
Qu’est-ce l'API du Géoportail?
Pourquoi l'API du Géoportail?
Comment ça marche?
Mise en œuvre
Galerie d’exemples
Conclusion
I. Qu’est-ce que l'API du Géoportail?
Qu’est-ce que l'API du Géoportail?
varOpenLayers={sin
gleFile:true};OpenLa
yers.String={startsW
ith:function(b,a){ret
urn(b.indexOf(a)==0
)},contains:function(
b,a){…
1- L’IGN fournit une
bibliothèques de fonctions
(code source) Géoportail
2- Un webmaster utilise ce code
pour interfacer son site Web avec
le Géoportail
3- Un site Web affiche les
référentiels Géoportail via sa
propre interface en ajoutant
ses propres outils
Qu’est-ce que l'API du Géoportail?
Une bibliothèque de fonctions qui permet:
d’intégrer une cartographie dynamique dans son site Web.
de superposer des couches métiers utilisateurs avec les
référentiels Géoportail
Disponible dans deux langages: JavaScript et Flex
Avantages:
Liaison directe avec les référentiels IGN
Bibliothèque OpenSource
De nombreux outils et services web
Evolutive (retours des utilisateurs) + support IGN
Les données de référence Géoportail
89 couches de données en Juin 2012
Couverture nationale (France métropolitaine, DOM et TOM)
Une mise à jour continue des données IGN
En superposition avec vos référentiels
Différentes méthodes disponibles pour afficher ses propres
données dans les principaux standards du Web (KML, GPX,
WMS,…)
Des outils facilitant l’affichage des données métiers (popups,
styles, reprojection)
Les principales fonctionnalités
Gestionnaire
de couches
Outils d’édition de
géométries
Outil d’export de
données
Outil d’import
de données
Outils
d’impression
Outils de mesure
Outils de
Géocodage
Les différentes APIS
API Géoportail JavaScript (2D)
API Géoportail Flex (2D)
API Géoportail 3D
L’API JavaScript
Projet OpenSource :
possibilité de récupérer et modifier les sources (débogage)
Socle OpenLayers + gestion des projections (proj4)
Historique des versions
Les différents niveaux de l’API JS
API Minimum:
Contient uniquement les surcharges nécessaires à l'affichage des
données de l'infrastructure Géoportail
Connexions aux
flux Géoportail
Les différents niveaux de l’API JS
API Standard:
Contient la plupart des fonctionnalités, des outils et des éléments
d'interface graphique
Connexions aux
flux Géoportail
Interface graphique
Gestionnaire
des couches
Gestionnaire des
projections, échelles
Les différents niveaux de l’API JS
API Etendue:
Contient l’intégralité des fonctionnalités
...
Impression
Mesures
Recherche par
adresses
Recherche de
métadonnées
Dessin
Historique de
navigation
L’API Flash
Utilise Openscales
L’API Géoportail Flex est plus récente que la JavaScript et n'a
connu que 2 versions.
La version 2.0 est celle qui est utilisée par le site internet du
Géoportail dans sa 3e version : http://www.geoportail.gouv.fr.
14
Choisir entre l’API JS et l’API Flash
Les APIs JavaScript et Flex sont iso-fonctionnelles.
Il existe quelques critères à prendre en considération lors du choix de
l'une ou l'autre des APIs Géoportail:
API Javascript
Avantages:
Repose sur un projet solide : OpenLayers
Communauté d’utilisateurs étendue
fonctionne sur toutes les plateformes
Inconvénients:
Ralentissements à l’affichage simultané de plus de 100 à 200 objets
vectoriels
Choisir entre l’API JS et l’API Flash
API Flash
• Avantages:
Affichage est plus fluide et graphisme plus élaboré.
Gestion des objets vectoriels plus performante
Intégration multi-plateforme facilitée
• Inconvénients:
est exécutée grâce à un plugin
API 3D
Réalisée en javascript
permet d'intégrer dans une page web le globe virtuel VirtualGeo
avec les données du Géoportail.
L’API Haut Niveau (AHN)
L'API Haut Niveau est constituée :
• d'un loader: méthode pour charger le client de visualisation 2D JavaScript,
2D Flash ou 3D
• de setters: appelables depuis l'objet JavaScript interfaceViewer, retourné
par le loader pour interagir avec le viewer
• d’évènements : envoyés par le viewer auxquels l'interfaceViewer peut
s'abonner
II. Pourquoi l’API du Géoportail
A quels besoins répond l’API Géoportail? (1/2)
Visualiser de l’information géographique
Des données IGN
Des données partenaires (WMS, WFS, KML, GML, etc.)
Publier des données métiers
Dans les principaux formats standards du Web
A quels besoins répond l’API Géoportail?(2/2)
Saisir des données
Géométrie simple (point, ligne, polyligne)
Sur fond de données de référence
Dans l’esprit Web …
A destination d’un public large
Pour une utilisation relativement basique en terme de
fonctionnalités : Visualisation, superposition, saisie de formes
simples et/ou d’attributs
III. L’API du Géoportail
Comment ça marche?
L’infrastructure Géoportail
Les données
L'infrastructure du Géoportail héberge des données brutes sous différents
formats:
image (ortho photographies, cartes scannées, etc.)
vectoriel (routes de la BDTOPO® par exemple).
Tuiles d’images pré-calculées
Clef API et droits d'accès aux services Web
les données de l'infrastructure Géoportail sont regroupées selon la notion
de couches thématiques multi-échelles:
Exemple: la couche "Réseaux routiers" renvoie suivant les échelles
d'affichage des données issues des bases de données :
EuroGlobalMap, EuroRegionalMap, BD CARTO® et BD TOPO®.
24
Les services du Géoportail
Le Géoportail propose divers services de diffusion de données:
WMS : met à disposition d’utilisateurs distants des données
raster ou vecteur géoréférencées via une simple requête HTTP.
WFS : sert à diffuser des données vecteur
WMTS: permet de diffuser des images en utilisant des tuiles
prédéfinies
Geocodage direct: à l’adresse, au nom de lieu ou à la parcelle
cadastrale
Geocodage inverse
Web Map Tile Service (WMTS)
Le service WMTS (Web Map Tile Service) permet de diffuser des
images en utilisant des tuiles prédéfinies.
Les performances sont ainsi bien meilleures que celles d’un WMS.
Mise en œuvre
Les tuiles du WMTS sont organisées sous forme d’une pyramide
d’images de 256x256 pixels.
Chaque niveau de pyramide correspond à un niveau d’échelle.
Définition d’une projection unique
Pyramide d’images précalculées
21 échelles prédéfinies pour le Géoportail (du monde à la rue)
Une pyramide par couche de données
Contraintes de sécurité
Chaque requête aux serveurs nécessite une clé d’accès représentée par
une chaîne unique de 24 caractères alpha-numériques.
Exemple de requête
http://gpp3-wxs.ign.fr/key/geoportail/r/wms?SERVICE=WMS&REQUEST=GetCapabilities
Clef API et droits d'accès aux services Web
Il existe deux types de clefs :
Les clefs referer/IP/User-Agent
Les clefs login/password
Affichage de données
Projection :
Projection Web Mercator Sphérique
Une projection pour tous les territoires
Compatible avec les systèmes de référence de
coordonnées suivants:
WGS84
RGF93 géographique
ETRS89 géographique (INSPIRE)
sinon il faut reprojeter…
29
IV.L’API du Géoportail
Mise en oeuvre
Les Conditions d’Utilisation de la licence
Offre gratuite
Pour des usages Web ne procurant aucun avantage
économique direct ou indirect ou avec une utilisation limitée
Pour un usage de type SIG dans le cadre d’une mission de
service public
Offre commerciale
Pour un site web commercial
Pour une application SIG privée ou mobile
La documentation
Tutoriels
Pages d’exemples
Documentation développeur
Forum
Le forum API
• Lancé en mai 2009
• Lieu d’échanges entre l’IGN et développeurs
• Aide à la résolution de problèmes
• Patch correctifs avant mise en production
V. Galerie d’exemples
Galerie d’exemples
Site institutionnel
http://www.inrap.fr/archeologie-preventive/Sites-archeologiques/
L'Institut National de Recherches Archéologiques Préventives
Galerie d’exemples
Site institutionnel
http://public.geofoncier.fr/
Portail GéoFoncier de l’Ordre des Géomètres-Experts
37/43
Galerie d’exemples
Site institutionnel
http://www.observatoire.savoie.equipement-agriculture.gouv.fr/
Observatoire de Territoires de la Savoie
Prévention des risques naturels
Galerie d’exemples
Site loisirs
http://www.utagawavtt.com
Randonnée VTT
Partager son parcours à partir de sa trace GPS
Galerie d’exemples
Site loisirs
http://vivlig.free.fr/
anciennes cartes postales des communes du Haut-Lignon et du HautVivarais
VI.Pour conclure
L’API Géoportail c’est :
Des accès natifs à des services reposants sur des standards
en géomatique tels que :
WMS, WMTS…
WFS, OpenLS …
KML, GPX, OSM …
Des composants intégrables dans une application :
Navigation, Mesures, Recherches
Des possibilités d’extension, d’adaptation
L’API Géoportail ce n’est pas :
Une application figée, clef en main :
C’est une Interface de Programmation d’Applications
Un accès limité aux seuls flux du Géoportail :
Google, Bing, Yahoo sont « insérables »
Vos WMS, WFS, KML etc… aussi
Un moyen pour l’IGN de récupérer vos données
Ce n’est pas le cas de Google
Une bibliothèque sans support