API Géoportail… en version bêta
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.
+ 
Pour Virtual Earth 3D, l’IGN accorde également à Microsoft une licence pour son modèle numérique de terrain (information d’altitude), BD Alti®, offrant ainsi un meilleur rendu des “reliefs”. Ceci sera disponible dans Virtual Earth d’ici l’été 2008.
" En effet, dans Virtual Earth, le "moteur" de Live Search Maps, nous n’avons que 9 zones urbaines couvertes en ortho photos. Ainsi, mes amis de MSN France ont décidé de ne pas lancer Live Search Maps en France pour ne pas décevoir nos utilisateurs. " 
