Cela fait 2 ans que Géoportail a été annoncé par l’IGN, souvenez-vous en avril 2006. Il y avait déjà une forte attente de la part du public. Le lancement de Géoportail en juin 2006 n’a fait que consolider l’engouement pour les internautes de voir leur "chez soi" vu du ciel.
Dans le monde du géospatial, l’API était tout aussi attendue. En effet, les données géographiques de l’IGN sont très vérrouillées (même si l’IGN est un établissement public de l’Etat), et le fait de pouvoir "manipuler" simplement ces données à travers une API était très attendu.
https://api.ign.fr/geoportail/
Qu’est-ce que l’API Géoportail ?
- "Ortho Photos" (avec des données de Planet Observer hors France métropolitaine)
- Cartes IGN
- KML (Keyhole Markup Language)
- WMS (Web Map Service)
- WFS (Web Feature Service)
L’API Géoportail, qu’en est il?
Première précision importante, il s’agit d’une version bêta. Ceci est clairement préciser dans les conditions générales mais très peu sur le site :
API Géoportail Web 2D version Bêta (ou « API bêta ») : package fourni au Bêta-Testeur (…)
L’IGN sollicite de votre part la remontée d’informations provenant de développeurs ou
d’utilisateurs finals de l’API bêta. Vous êtes donc invités à nous donner vos points de vue et
réactions sur l’API bêta et vous pouvez nous envoyer vos idées sur les perfectionnements,
améliorations et autres changements concernant l’API bêta par courrier électronique à
l’adresse contact.api@ign.fr .
D’où des restrictions d’utilisation très fortes pour ce lancement :
- Pas d’utilisation commerciale de l’API Géoportail Bêta ;
- Au maximum 100 pages vues par jour et par clé d’utilisation ;
- Au maximum 10 000 tuiles de 256 x 256 pixels chargées par jour et par clé d’utilisation ;
- Une taille de fenêtre cartographique de 400 x 400 pixels au maximum.
100 pages vues par jour, c’est très limité et ne permet donc pas de s’adapter à un site web.
Cette version bêta s’adresse donc aux développeurs, aux spécialistes des SIG qui pourraient remonter leurs avis à l’IGN. Donc un peu d’indulgence comme le souligne Luc Vaillancourt sur Baliz-Media. 
Il s’agit donc d’une version gratuite, appelée API Géoportail Web 2D. Selon les FAQ, une version payante est en préparation ainsi qu’une version 3D. Ceci confirme les propos de Patrick Leboeuf lors du Géo-événement 2008.
Les fonctionnalités
Entrons dans l’API… du moins essayons
Pour pour utiliser cet API, le parcours est assez classique
- Créer un compte
- Votre compte créé et validé, vous pouvez demander un nouveau contrat
- Vous sélectionnez un "client", pour le moment vous avez que "client léger 2D"
- Vous sélectionnez l’emprise (territoire que vous voulez visualiser sur votre carte) parmis :
- France métropolitaine
- Guadeloupe
- Martinique
- Guyane Française
- Réunion
- Mayotte
- Saint-Pierre-et-Miquelon
- Iles Crozet
- Nouvelle Calédonie
- Polynésie Française
- Saint-Barthélemy
- Saint-Martin
- Wallis-et-Futuna - Précisez votre URL de site
- Vous obtenez la clé de votre contrat et un code exemple
L’API Géoportail 2D permet d’intégrer en quelques lignes une carte Géoportail dans une page HTML.
Un shéma explique la structure de l’API Géoportail :
… mais je n’ai pas tout saisi….
Etudions le code d’exemple :
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>API Geoportail – votre carte personnelle</title>
<script src="http://api.ign.fr/api?v=1.0beta&key=8750437567523772095&instance=map"></script>
<script type="text/javascript">
function initGeoportalMap() {
geoportalLoadmap("GeoportalMapDiv", "normal", "FXX");
if(map.allowedGeoportalLayers){
map.addGeoportalLayers(map.allowedGeoportalLayers);
}
}
</script>
</head>
<body>
<div id="GeoportalMapDiv" style="width:400px;height:400px;"></div>
</body>
</html>
- Placer une balise script qui fait appel à la page de vérification de licence. Vous devez remplacer le paramètre key par votre clé de licence;
- Vous devez remplacer le paramètre instance par le nom que vous voulez donné à la carte et qui vous servira ensuite pour configurer cette carte. Ce nom sera celui de la variable Javascript de votre carte;
- Placer dans le corps de la page HTML une balise DIV dont les attributs ID class et style sont renseignés comme dans le code qui suit;
- Définir la fonction Javascript initGeoportalMap() cette fonction sera exécutée au chargement de la page pour initialiser votre carte;
Il existe 2 types de cartes :
normal : carte avec tous les panneaux visibles (gestionnaire de couche, boîte à outils et panneau d’information)
petite taille : carte de petite taille sans panneaux. Les déplacements et les zooms se font avec la souris.
La documentation est mise à disposition. Malheureusement elle n’est pas très lisible. Un minimum d’exemples sont là pour éventuellement vous guider. Pour aller plus loin dans la manipulation de ces cartes, il faut maîtriser l’API OpenSource Openlayers.
Conclusion
Cette API Géoportail était très attendue. Elle poursuit la logique de mise à disposition du public des données de l’IGN.
8 commentaires
1 TOMHTML // 5 mai 2008 à 13:04
Avec une API de 761 Ko, je comprends que c’est limité à 100 pages vues par jour !
2 ibob // 5 mai 2008 à 14:09
Le poids de l’api n’est pas forcement handicapant car ce sont surtout les images qui pèsent lourd dans ce genre d’application.
Ce que je trouve vraiment dommage, c’est de trouver des photos aérienne de piètre qualité comparé aux autres acteurs du système (même pas français).
Les fonds de cartes sont aussi très peu lisibles, surtout pour les grandes villes.
La documentation est très faible mais on peut mettre ca sur le compte de la jeunesse du système.
Bref, je ne suis pas convaincu à 100%.
3 jean-phil // 8 mai 2008 à 12:20
« En effet l’API Géoportail n’est qu’une simple interface pour afficher sur votre site les données cartographiques de l’IGN »
Je ne suis pas tout a fait d’accord, en feuilletant la doc , on peut ajouter des kml, des wms et wfs, autre que celles des données géoportail, avec des projection autres que celles du géoportail.Voir l’exemple Martinique pour le kml.
4 JLD // 17 mai 2008 à 8:42
Avez-vous déjà affiché une carte avec cet API sur vos pages web? Je ne parviens qu’à débuter l’affichage de la carte (1/4 supérieur) et le navigateur est ensuite définitivement planté.
Que doit-on faire avec le geoportal.js? Le télécharger dans le dossier du site? l’appeler comment? Bref, si vous avez des copies de scripts sur vos pages qui fonctionnent, je suis preneur.
5 Renaud // 25 mai 2008 à 16:31
@JLD
Oui l’API semble bien fonctionner.
Voici un exemple que j’ai réalisé : http://www.renalid.com/exemples/IGN.html
6 orcima // 21 février 2009 à 11:47
J’ai créé un bouton pour afficher la même vue que ma fenêtre api google map sur l’api geoportail
ça marche mais par contre mon fichier KML ne s’affiche pas
Il est pourtant bien dans la liste des couches.
J4ai aussi testé un KMZ mais ça produit une erreur de lecture donc ce n’est pas supporté
Connaissez vous des restriction au format KML dans l’api Geoportail ?
7 hf974 // 3 mars 2009 à 14:42
il me semble qu’il faut passer par un proxy pour pouvoir ajouter une couche kml mais je n’arrivve pas à configurer ce proxy
https://api.ign.fr/geoportail/doc/fr/webmaster/proxy_wfs.html
8 Un prototype de Geoportail sur iPhone // 11 septembre 2009 à 14:32
[...] s’agirait d’un prototype utilisant l’API Geoportail créé par un développeur [...]
Laissez un commentaire!