Adaptation au nouveau service de calcul d’itinéraires
- 1. Généralités
- 2. Attributs de l’ancien service
- 3. Attributs du nouveau service
- 4. Equivalences
- 5. Différences de réponses
- 6. Exemple de requête et de réponse
Table des matières
Titre
1. Généralités
Ce tutoriel vous explique comment transposer une requête effectuée avec l'ancien service en une requête équivalente avec le nouveau.
Titre
2. Attributs de l’ancien service
L’ancien service faisait appel à l'URL suivante :
http://wxs.ign.fr/calcul/itineraire/rest/route.json
Associés à cette URL, il y avait les paramètres suivants :
Paramètre |
Valeurs |
Optionnel |
Valeur par défaut |
|
origin |
Longitude, latitude |
non |
- |
|
destination |
Longitude, latitude |
non |
- |
|
waypoints |
Etapes : longitude1, latitude1 ; longitude1… |
oui |
- |
|
method |
"distance" - "time" |
oui |
time |
|
srs |
Code EPSG |
oui |
EPSG:4326 |
|
exclusions |
"Toll" - "Tunnel" |
oui |
- |
|
graphName |
string |
oui |
Voiture |
Plus d’informations concernant l’ancien service ici.
Titre
3. Attributs du nouveau service
Le nouveau service fait appel à l'URL suivante :
https://wxs.ign.fr/calcul/geoportail/itineraire/rest/1.0.0/route
Associés à cette URL, il y a les paramètres suivants :
Paramètre |
Valeurs |
Optionnel |
Valeur par défaut |
|
resource |
"bdtopo-osrm" |
non |
- |
|
start |
Longitude, latitude |
non |
- |
|
end |
Longitude, latitude |
non |
- |
|
intermediates |
Etapes : longitude1, latitude1 ; longitude1… |
oui |
- |
|
profile |
"car" - " "pedestrian" |
oui |
car |
|
optimization |
"shortest" - "fastest" |
oui |
fastest |
|
getSteps |
"true" - "false" |
oui |
true |
|
waysAttributes |
- |
oui |
- |
|
geometryFormat |
"polyline" - "geojson" |
oui |
geojson |
|
crs |
"EPSG:4326" - "EPSG:2154" |
oui |
EPSG:4326 |
|
timeUnit |
"hour" - "minute" - "second" |
oui |
minute |
|
distanceUnit |
"meter" - "kilometer" |
oui |
meter |
|
constraints |
["constraintType","key","operator","value"] |
oui |
- |
Plus d’informations concernant le nouveau service ici.
Titre
4. Equivalences
Le tableau suivant indique les correspondances entre les paramètres d'une requête de l'ancien service et ceux du nouveau.
Ancien paramètre |
Nouveau paramètre |
Anciennes valeurs |
Nouvelles valeurs (si différentes) |
|
origin |
start |
Longitude, latitude |
- |
|
destination |
end |
Longitude, latitude |
- |
|
waypoints |
intermediates |
Etapes |
- |
|
method |
optimization |
"distance" |
"shortest" |
|
srs |
crs |
Code EPSG |
- |
|
exclusions |
constraints |
"Toll" - "Tunnel" |
["constraintType","key","operator","value"] |
|
graphName |
profile |
"Voiture" |
"car" |
|
- |
resource |
- |
"bdtopo-osrm" |
|
- |
getSteps |
- |
"true" - "false" |
|
- |
waysAttributes |
- |
- |
|
- |
geometryFormat |
- |
"polyline" - "geojson" |
|
- |
timeUnit |
- |
"hour" - "minute" - "second" |
|
- |
distanceUnit |
- |
"meter" - "kilometer" |
Titre
5. Différences de réponses
Le tableau suivant indique les correspondances entre les réponses renvoyées par l'ancien service et le nouveau.
Ancien service |
Nouveau service |
Type Ancien |
Type Nouveau |
|
distance |
distance |
"XX.XX Km" |
"XXXX" |
|
duration |
duration |
"XX:XX:XX" |
"XXXX" |
|
distanceMeters |
- |
"XXXX" |
- |
|
durationSeconds |
- |
"XXXX" |
- |
|
bounds |
bbox |
"lon1,lat1;lon2,lat2" |
[0: "lon1",1:"lat1",2 :"lon2",3 :"lat2"] |
|
geometryWkt |
geometry |
Linestring |
Type indiqué en requête (défaut : geojson) |
|
simplifiedWkt |
- |
Linestring |
- |
|
legs |
portions |
[leg1,leg2,…] |
[portion1,portion2,…] |
|
- |
resource |
- |
(identique à la requête en entrée) |
|
- |
resourceVersion |
- |
Date d'actualité de la ressource routière YYYY-MM-DD |
|
- |
start |
- |
(identique à la requête en entrée) |
|
- |
end |
- |
(identique à la requête en entrée) |
|
- |
profile |
- |
(identique à la requête en entrée) |
|
- |
optimization |
- |
(identique à la requête en entrée) |
|
- |
crs |
- |
(identique à la requête en entrée) |
|
- |
distanceUnit |
- |
(identique à la requête en entrée) |
|
- |
timeUnit |
- |
(identique à la requête en entrée) |
|
- |
constraints |
- |
(identique à la requête en entrée) |
Titre
6. Exemple de requête et de réponse
La requête suivante :
http://wxs.ign.fr/CLEF/itineraire/rest/route.json?method=DISTANCE&origin=2.3017215728759766,48.81876120037664&destination=2.324380874633789,48.8287067867079&exclusions=Tunnel
Devient la requête :
https://wxs.ign.fr/calcul/geoportail/itineraire/rest/1.0.0/route?resource=bdtopo-pgr&profile=car&optimization=shortest&start=2.3017215728759766,48.81876120037664&end=2.324380874633789,48.8287067867079&intermediates=&constraints={"constraintType":"banned","key":"wayType","operator":"=","value":"tunnel"}
Qui renvoie le résultat disponible ici.
Les équivalences entre ces deux requêtes sont surlignées ici :
Et voici les deux réponses obtenues (affichage simplifié), à gauche pour l'ancien service, à droite pour le nouveau:
Les équivalences sont encadrées avec la même couleur.