-
Notifications
You must be signed in to change notification settings - Fork 0
/
index.html
132 lines (115 loc) · 7.89 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
<!--PhpDoc:
name: index.html
title: page d'accueil de https://igngp.geoapi.fr/
-->
<!DOCTYPE HTML><html><head><meta charset='UTF-8'><title>igngp.geoapi.fr</title></head><body>
<h2>igngp.geoapi.fr</h2>
Ce site propose 2 services pour simplifier la consommation des données exposées par le Géoportail de l'IGN.
Le premier simplifie l'utilisation de données images sous forme de tuiles et
le second simplifie l'utilisation des données vecteur au travers de serveurs OGC API Features.
<h3><a href='tile.php'>Tuiles au format XYZ</a></h3>
Le premier service consiste à exposer les données images du Géoportail de l'IGN selon les principes suivants :
<ol>
<li>L'idée principale est d'utiliser le format XYZ
(<a href='https://en.wikipedia.org/wiki/Tiled_web_map' target='_blank'>plus d'infos ici</a>)
qui est simple et a été largement popularisé par OSM et Google Maps,
et est donc largement utilisé nativement dans de nombreux progiciels,
comme <a href='https://leafletjs.com/' target='_blank'>Leaflet</a> ou Mapbox.
Ce format est plus simple que le standard WMTS utilisé par le Géoportail.<br>
Au travers de ce format, les tuiles sont accessibles en
<a href='https://en.wikipedia.org/wiki/Web_Mercator' target='_blank'>projection Web Mercator</a>
par l'URL :<br>
<code><b>https://igngp.geoapi.fr/tile.php/{layer}/{z}/{x}/{y}.[jpg|png]</b></code>
où:<ul>
<li><code>{layer}</code> est le nom de la couche</li>
<li><code>{z}</code> est le niveau de zoom</li>
<li><code>{x}</code> et <code>{y}</code> sont respectivement les numéros de colonne et de ligne de l'image</li>
<li><code>[jpg|png]</code> est le format de la tuile qui doit valoir <code>jpg</code> ou <code>png</code></li>
</ul>
<i>Exemple:</i>
<code><b><a href='tile.php/plan-ignv2/8/127/91.png'>https://igngp.geoapi.fr/tile.php/plan-ignv2/8/127/91.png</a></b></code>
est l'URL d'une tuile de la couche <code>plan-ignv2</code>.<br>
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 <code>png</code> soit <code>jpg</code>
tout en laissant les motifs {z}, {x} et {y} sans les remplacer.
Ainsi, par exemple, l'URL de la couche Plan IGN v2 est<br>
<code><b><a href='tile.php/plan-ignv2/{z}/{x}/{y}.png'>
https://igngp.geoapi.fr/tile.php/plan-ignv2/{z}/{x}/{y}.png</a></b></code>
</li>
<li>
Pour les couches pour lesquelles une clé est demandée dans le Géoportail, on l'ajoute à l'URL dont le motif devient :<br>
<code><b>https://igngp.geoapi.fr/tile.php/{layer}/{gpkey}/{z}/{x}/{y}.[jpg|png]</b></code>
où <code>{gpkey}</code> est la clé pour la couche.
<br><i>Exemple:</i><ul>
<li><a href='tile.php/cartes/ftdyo2un11l900zl1hyj29c7/8/127/91.jpg'>
<code>https://igngp.geoapi.fr/tile.php/cartes/ftdyo2un11l900zl1hyj29c7/8/127/91.jpg</code></a>
est l'URL d'une tuile de la couche cartes et</li>
<li><a href='tile.php/cartes/ftdyo2un11l900zl1hyj29c7/{z}/{x}/{y}.jpg'>
<code>https://igngp.geoapi.fr/tile.php/cartes/ftdyo2un11l900zl1hyj29c7/{z}/{x}/{y}.jpg</code></a>
est l'URL de la couche cartes avec une clé particulière</li>
<li><a href='tile.php/cartes/{key}/{z}/{x}/{y}.jpg'>
<code>https://igngp.geoapi.fr/tile.php/cartes/{key}/{z}/{x}/{y}.jpg</code></a>
est l'URL de la couche cartes sans clé particulière</li>
</ul>
Attention, la clé fournie n'est utilisable qu'à partir du site geoapi.fr
</li>
<li>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 <a href='tile.php'>tile.php</a> sans paramètre.
<li>De plus, les noms de couches sont simplifiés par rapport au Géoportail IGN.
<li>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 <a href='api'>document https://igngp.geoapi.fr/api</a>.
</ol>
<h3><a href='fts.php'>Serveurs d'objets vectoriels conformes au protocole OGC API Features</a></h3>
<!-- <p><b>ATTENTION, En cours de développement !</b></p> -->
Le second service cherche à faciliter l'accès aux données vecteur,
premièrement à tout un chacun en interactif en Html,
deuxièmement aux développeurs ne connaissant pas le standard WFS
et enfin, troisièmement, aux géomaticiens utilisant QGis.
Il consiste à exposer les données vecteur du Géoportail sous la forme d'un bouquet de serveurs conformes
au <a href='http://docs.opengeospatial.org/is/17-069r3/17-069r3.html' target='_blank'>standard OGC API Features</a>,
avec un serveur par thème du Géoportail.
Les intérêts principaux de ce standard sont :<ol>
<li>l'utilisation d'une API<ul>
<li>plus conforme aux principes du web que l'utilisation des services WFS
(pour plus d'infos voir <a href='https://www.w3.org/TR/dwbp/' target='_blank'>https://www.w3.org/TR/dwbp/</a>
et <a href='http://www.opengis.net/doc/WP/api-whitepaper' target='_blank'>
OGC® Open Geospatial APIs - White Paper
</a>),</li>
<li>notamment documenté par des documents Open API
et donc plus facile à utiliser par les développeurs ne connaissant pas WFS,</li>
</ul></li>
<li>la possibilité de consulter les données des serveurs en Html en naviguant simplement dans les serveurs,</li>
<li>la possibilité d'utiliser des URL pour désigner une collection ou un objet, par exemples:<ul>
<li><a href='https://igngp.geoapi.fr/fts.php/administratif/collections/ADMINEXPRESS-COG-CARTO.LATEST:region'>
https://igngp.geoapi.fr/fts.php/administratif/collections/ADMINEXPRESS-COG-CARTO.LATEST:region</a>
pour la collection des régions d'ADMIN-EXPRESS COG CARTO,</li>
<li><a href='https://igngp.geoapi.fr/fts.php/administratif/collections/ADMINEXPRESS-COG-CARTO.LATEST:region/items/region.1'>
https://igngp.geoapi.fr/fts.php/administratif/collections/ADMINEXPRESS-COG-CARTO.LATEST:region/items/region.1</a>
pour la région identifiée par 'region.1' dans la collection précédente,</li>
</ul>
<li>la possibilité d'ajouter une documentation accessible dans QGis, principalement<ul>
<li>des titres de collections plus clairs et plus courts que ceux utilisés par l'IGN,</li>
<li>un résumé de la collection accessible dans QGis reprenant des éléments de spécification des données.</li>
</ul>
<li>la possibilité d'utiliser les URLs de ces serveurs dans des cartes Leaflet
(plug-ins <a href='https://github.com/calvinmetcalf/leaflet-ajax'>leaflet-ajax</a>
et <a href='https://github.com/BenjaminVadant/leaflet-ugeojson'>uGeoJSON</a>)
avec une limite importe due au nombre limité d'objets qu'il est possible de lire dans Leaflet.</li>
</ol>
Les différents serveurs sont accessibles à l'adresse <a href='fts.php'>https://igngp.geoapi.fr/fts.php</a>
<a id='cu'></a>
<h3>Conditions d'utilisation</h3>
Les données exposées sont diffusées par l'IGN selon les conditions suivantes :
<table border=1><tr><td>
Les données présentes sur le site sont gratuites et disponibles en licence ouverte selon le principe de la licence Etalab 2.0
depuis le 1er janvier 2021.
D’autres données complètent la politique d’ouverture des données de l’IGN depuis le 1er juin 2021.
Les données SCAN 25®, SCAN 100® et SCAN OACI sont ainsi gratuites en téléchargement ou en flux mais seulement
pour un usage professionnel ou associatif.
Tout professionnel ou particulier souhaitant développer une offre commerciale papier ou numérique destinée au grand public
devra s’acquitter d’une redevance
selon les <a href='https://geoservices.ign.fr/cgu-licences' target='_blank'>conditions générales d’utilisation</a> (CGU).
</table><br>
De plus, <b>ATTENTION, ce site est un prototype et ne fait l'objet d'aucune garantie de performance
ou de continuité de service</b>.</p>
Pour plus d'informations sur ce site, vous pouvez contacter <a href='mailto:contact@geoapi.fr'>Benoit DAVID</a>.