Options GetRoute POST HTTP
Format d'URL POST HTTP
Outre les paramètres GET HTTP habituels, vous pouvez ajouter des options de charge utile POST HTTP à votre requête qui spécifie les points intermédiaires, les mises à jour transitoires et la priorité des types de route. Le type de contenu doit être défini sur application/json. Les requêtes POST HTTP se présentent au format suivant :
HTTP POST: /rest/Spatial/erm/databases/dbsource.json?q=route&query_parameters
POST BODY: Content-Type:application/json {Route Data}
Points intermédiaires
Liste de points intermédiaires à inclure tout au long de l'itinéraire. Pour inclure un ensemble de points intermédiaires à une requête HTTP POST, ajoutez la charge utile MultiPoint JSON indiquant les points inclus dans l'itinéraire. Si des points intermédiaires sont indiqués à la fois dans l'URL et dans la charge utile json, cette dernière est prioritaire et les points intermédiaires de la l'URL sont ignorés.
Exemple de charge utile POST HTTP avec des points intermédiaires.
{
"intermediatePoints": {"type": "MultiPoint","crs": {"type": "name","properties": {"name": "epsg:4326"}},"coordinates": [[ -73.976266,40.788717],[ -73.973562,40.792193],[ -73.971802,40.794630]]}
}
Mises à jour transitoires
Cet ensemble de préférences vous permettent de définir des mises à jour transitoires pour chaque requête. Par exemple, vous pouvez requérir que le serveur essaie d'éviter toutes les routes principales. Chaque requête peut contenir une ou plusieurs mises à jour. Pour les mises à jour de la vitesse, une valeur de vitesse positive augmente la vitesse et une valeur de vitesse négative réduit la vitesse. Voici une description des types de mise à jour transitoire :
Type de mise à jour |
Description |
---|---|
point |
Les mises à jour de point constituent des modifications apportées à un point correspondant (Latitude, Longitude). Pour un point donné, vous pouvez réaliser les opérations suivantes : exclure le point, définir la vitesse du point ou modifier (augmenter ou réduire) la vitesse du point d'une valeur ou d'un pourcentage. Utilisez l'un des types de mise à jour suivants :
|
segmentID |
Les mises à jour de segment constituent des modifications apportées à un ID de segment correspondant. Pour un segment donné, vous pouvez réaliser les opérations suivantes : exclure le segment, définir la vitesse du segment, modifier (augmenter ou réduire) la vitesse du segment d'une valeur ou d'un pourcentage ou modifier le type de route du segment. Utilisez l'un des types de mise à jour suivants :
|
roadType |
Les mises à jour de type de route constituent des modifications apportées à un type de route correspondant. Pour un type de route donné, vous pouvez réaliser les opérations suivantes : définir la vitesse du type de route ou modifier (augmenter ou réduire) la vitesse du type de route d'une valeur ou d'un pourcentage. Utilisez l'un des types de mise à jour suivants :
|
Exemple de charge utile POST HTTP avec mise à jour transitoire.
{
"transientUpdates": [
{
"segmentID": "7e3396fc:151186f",
"updates": [
{"percentage": 26.0}
]
},
{
"point": {"type": "Point",
"crs":
{
"type": "name",
"properties":
{
"name": "epsg:4326"
}
},
"coordinates":
[
-73.972776,
40.795076
]
},
"updates": [
{"speedAdjustment" : { "velocity": 5, "velocityUnit": "kph"}}
]
},
{
"roadType": "major road dense urban",
"updates": [
{"speed": { "velocity": 25, "velocityUnit": "kph"}}
]
}
]
}
Restrictions de véhicule commercial
Les restrictions de véhicules commerciaux sont composées de directives relatives au moteur de routage qui guide le comportement et les attributs des véhicules commerciaux qui suivent l'itinéraire. Selon les attributs de véhicule fournis (tels que la hauteur, la largeur, la longueur, le poids) et les attributs de restriction de véhicules commerciaux présents sur le réseau routier, il est décidé si l'on peut autoriser un véhicule donné à circuler sur un segment ou non. S’il n’existe aucun attribut de restriction de véhicules commerciaux présent sur le réseau routier, les paramètres de restriction d’entrée n'auront aucun effet sur l’itinéraire qui en résulte.
Voici l’ensemble des paramètres pour les restrictions de véhicules commerciaux :
Option | Description |
---|---|
looseningBarrierRestrictions |
Lors de la détermination de l'itinéraire, indique que les barrières seront supprimées. Ces restrictions sont le plus souvent utilisées lorsque la réglementation locale interdit à un véhicule commercial de traverser un segment ou lorsqu'un véhicule commercial est autorisé sur le segment, mais seulement s'il ne peut pas faire autrement (par exemple, accès au dernier kilomètre, livraison locale, etc.). Les itinéraires dont une barrière a été supprimée continuent à représenter un coût d'itinéraire supérieur, même s'ils sont plus courts/plus rapides qu'un itinéraire sans barrière. |
vehicleAttributes |
Lors de la détermination de l'itinéraire, indique les détails du véhicule faisant l'objet de la restriction en fonction de son type, sa hauteur, son poids, sa longueur ou sa largeur. Les véhicules commerciaux sont divisés en différents types, des véhicules à remorque courte aux longs véhicules à trois remorques. L'attribution des restrictions de véhicule commercial est organisée par type de véhicule. Cela signifie qu'il est parfaitement possible qu'un segment soit préféré pour un type de véhicule et qu'il fasse l'objet d'une restriction pour un autre type. Utilisez les types d'informations sur le véhicule suivants :
|
Exemples
Sans restrictions de véhicules commerciaux
Requête :
HTTP GET /rest/Spatial/erm/databases/US_CVR.json?q=routeCostMatrix&startPoints=-74.7221203,42.9737073,epsg:4326&endPoints=-74.6671887,42.8097083,epsg:4326
Réponse :
{
"matrix": [{
"distance": 40025,
"distanceUnit": "m",
"endPoint": {
"type": "Point",
"coordinates": [-74.6671887, 42.8097083]
},
"startPoint": {
"type": "Point",
"coordinates": [-74.7221203, 42.9737073]
},
"time": 36.57,
"timeUnit": "min"
}]
}
Avec restrictions de véhicules commerciaux
Requête :
HTTP GET /rest/Spatial/erm/databases/US_CVR.json?q=routeCostMatrix&startPoints=-74.7221203,42.9737073,epsg:4326&endPoints=-74.6671887,42.8097083,epsg:4326
Charge utile POST HTTP avec restrictions de véhicules commerciaux.
{
"cvr":{
"looseningBarrierRestrictions":"n","vehicleAttributes":{
"vehicleType":"ALL","heightUnit":"meter","height":"4","weightUnit":"Kilogram","weight":"40000"
}
}
}
Réponse :
{
"matrix": [{
"distance": 44933,
"distanceUnit": "m",
"endPoint": {
"type": "Point",
"coordinates": [-74.6671887, 42.8097083]
},
"startPoint": {
"type": "Point",
"coordinates": [-74.7221203, 42.9737073]
},
"time": 37.48,
"timeUnit": "min"
}]
}
la valeur de distance et de temps a changé avec CVR.
Priorité des types de route
Indique la priorité à attribuer aux différents types de routes lors de l'établissement de l'itinéraire. Voici une description des options de priorité des types de route :
Option |
Description |
---|---|
Haut |
Préférer ce type de route aux autres types de routes. |
Moyen |
Donner à ce type de route une préférence égale aux autres types de routes. Si aucune préférence n'est spécifiée pour un type de route, la valeur par défaut est Moyen. |
Bas |
Préférer d'autres types de routes à ce type de route. |
Éviter |
Exclure le type de route des itinéraires si possible. Il n'est pas toujours possible d'exclure un type de route des directions de trajet. Selon la situation, l'alternative à un type de route évité peut être si insignifiante que le logiciel choisira un itinéraire qui utilise un type de route évité. Par ailleurs, si le point de départ ou d'arrivée se situe sur un segment dont le type de route a été évité, le logiciel utilisera tout de même ce segment. |
Exemple de charge utile POST HTTP avec priorité de type de route.
{
" roadTypesPriority ": {
"RoadType.MajorRoadDenseUrban": "High",
"RoadType.LimitedAccessDenseUrban":"Low",
"RoadType.LimitedAccessRural":"Medium",
"RoadType.PrimaryHighwayUrban":"Avoid"
}
}