igngp.geoapi.fr

Tuiles au format XYZ

1. L'idée principale est d'utiliser le format XYZ (plus d'infos ici) qui est simple et a été largement popularisé par OSM et Google Maps, et est donc largement utilisé nativement dans de nombreux progiciels, comme Leaflet ou Mapbox. Ce format est plus simple que le standard WMTS utilisé par le Géoportail.
   Au travers de ce format, les tuiles sont accessibles en projection Web Mercator par l'URL :
   https://igngp.geoapi.fr/tile.php/{layer}/{z}/{x}/{y}.[jpg|png] où:
   • {layer} est le nom de la couche
   • {z} est le niveau de zoom
   • {x} et {y} sont respectivement les numéros de colonne et de ligne de l'image
   • [jpg|png] est le format de la tuile qui doit valoir jpg ou png
   Exemple: https://igngp.geoapi.fr/tile.php/plan-ignv2/8/127/91.png est l'URL d'une tuile de la couche plan-ignv2.
   En pratique, dans la plupart des logiciels la couche est définie par l'URL dans laquelle on remplace le motif {layer} par le nom effectif de la couche ainsi que le format par soit png soit jpg tout en laissant les motifs {z}, {x} et {y} sans les remplacer. Ainsi, par exemple, l'URL de la couche Plan IGN v2 est
   https://igngp.geoapi.fr/tile.php/plan-ignv2/{z}/{x}/{y}.png
2. Pour les couches pour lesquelles une clé est demandée dans le Géoportail, on l'ajoute à l'URL dont le motif devient :
   https://igngp.geoapi.fr/tile.php/{layer}/{gpkey}/{z}/{x}/{y}.[jpg|png] où {gpkey} est la clé pour la couche.
   Exemple:
   • https://igngp.geoapi.fr/tile.php/cartes/ftdyo2un11l900zl1hyj29c7/8/127/91.jpg est l'URL d'une tuile de la couche cartes et
   • https://igngp.geoapi.fr/tile.php/cartes/ftdyo2un11l900zl1hyj29c7/{z}/{x}/{y}.jpg est l'URL de la couche cartes avec une clé particulière
   • https://igngp.geoapi.fr/tile.php/cartes/{key}/{z}/{x}/{y}.jpg est l'URL de la couche cartes sans clé particulière
   Attention, la clé fournie n'est utilisable qu'à partir du site geoapi.fr
3. La seconde idée est de simplifier l'accès à la documentation et de proposer de prévisualiser simplement les couches au moyen d'une carte Leaflet accessible à partir de l'appel de tile.php sans paramètre.
4. De plus, les noms de couches sont simplifiés par rapport au Géoportail IGN.
5. Au final, ce service prend la forme d'un ensemble de couches tuilées qui est documenté au format Open API 3.0 dans le document https://igngp.geoapi.fr/api.

Serveurs d'objets vectoriels conformes au protocole OGC API Features

1. l'utilisation d'une API
   • plus conforme aux principes du web que l'utilisation des services WFS (pour plus d'infos voir https://www.w3.org/TR/dwbp/ et OGC® Open Geospatial APIs - White Paper ),
   • notamment documenté par des documents Open API et donc plus facile à utiliser par les développeurs ne connaissant pas WFS,
2. la possibilité de consulter les données des serveurs en Html en naviguant simplement dans les serveurs,
3. la possibilité d'utiliser des URL pour désigner une collection ou un objet, par exemples:
   • https://igngp.geoapi.fr/fts.php/administratif/collections/ADMINEXPRESS-COG-CARTO.LATEST:region pour la collection des régions d'ADMIN-EXPRESS COG CARTO,
   • https://igngp.geoapi.fr/fts.php/administratif/collections/ADMINEXPRESS-COG-CARTO.LATEST:region/items/region.1 pour la région identifiée par 'region.1' dans la collection précédente,
4. la possibilité d'ajouter une documentation accessible dans QGis, principalement
   • des titres de collections plus clairs et plus courts que ceux utilisés par l'IGN,
   • un résumé de la collection accessible dans QGis reprenant des éléments de spécification des données.
5. la possibilité d'utiliser les URLs de ces serveurs dans des cartes Leaflet (plug-ins leaflet-ajax et uGeoJSON) avec une limite importe due au nombre limité d'objets qu'il est possible de lire dans Leaflet.

Conditions d'utilisation