GetSegmentData
Description
Le service GetSegmentData renvoie les informations de segment d'un point ou d'un ID de segment. Lorsque qu'un point est indiqué, les segments d'itinéraire les plus proches sont renvoyés. Lorsqu'un ID de segment est indiqué, les données d'itinéraire de ce segment d'itinéraire indiqué sont renvoyées.
Format d'URL GET HTTP
Les requêtes GET HTTP se présentent au format suivant : Les requêtes GET HTTP sont différentes selon qu'elles renvoient des données de segment au niveau d'un point ou d'un ID de segment.
Renvoi de données d'un segment au niveau d'un point donné :
HTTP GET /rest/Spatial/erm/databases/dbsource/segments.json?point=x,y,srsName&query_parameters
Renvoi de données d'un segment donné :
HTTP GET /rest/Spatial/erm/databases/dbsource/segments/segmentID.json?query_parameters
Où dbsource est le nom de la base de données contenant les données à utiliser pour l'itinéraire. Utilisez le nom de base de données indiqué dans l'outil de ressource de base de données de routage du module Enterprise Routing. segmentID est l'identifiant de segment dont vous souhaitez renvoyer les données.
Paramètres de requête
Cette opération accepte les paramètres de requête suivants.
Paramètre | Type | Obligatoire | Description |
---|---|---|---|
destinationSrs | Chaîne | non | Système de coordonnées dans lequel renvoyer les données de segment et la géométrie obtenue. Le système de coordonnées par défaut est celui des données utilisées. |
distanceUnit | Chaîne | non | Unités de renvoi de la distance. La valeur par défaut est m (mètre). Les valeurs disponibles sont les suivantes : m (mètre), km (kilomètre), yd (yard), ft (pied) et mi (mile). |
timeUnit | Chaîne | non | Unités de renvoi de la durée. La valeur par défaut est min (minute). Les valeurs disponibles sont les suivantes : min (minute), msec (milliseconde), s (seconde), h (heure). |
velocityUnit | Chaîne | non | Unités dans lesquelles renvoyer la vitesse. La valeur par défaut est mph (miles par heure). Les valeurs disponibles sont les suivantes : mph (miles par heure) et kph (kilomètres par heure). |
angularUnit | Chaîne | non | Unités dans lesquelles renvoyer les angles de braquage. La valeur par défaut est deg (degré). Les valeurs disponibles sont les suivantes : deg (degré), rad (radian), minute (minute), sec (seconde), grad (grade)). |
segmentGeometryStyle | Chaîne | non |
Format de la géométrie représentant un segment de l'itinéraire. La valeur par défaut est None. Indiquez ce paramètre si vous avez demandé le renvoi des géométries de segment. Les options de spécification des indications d'itinéraire sont les suivantes :
|
Exemples
Renvoie des données de segment indiquant un point.
http://www.pb.com/rest/Spatial/erm/databases/usroutedatabase/segments.json?point=-77,38,epsg:4326&segmentGeometryStyle=all
Réponse
[{
"segmentID": "aa18eb33:1b7bbe",
"primaryName": "VA-631",
"primaryNameLanguage": "en",
"alternateNames": [{
"alternateName": "Lloyds Rd",
"language": "en"
},
{
"alternateName": "VA-631",
"language": "en"
}],
"segmentLength": 4.954,
"segmentLengthUnit": "mi",
"timeTaken": 5.9333,
"timeUnit": "min",
"turnAngle": 0.0,
"turnAngleUnit": "deg",
"compassDirection": "",
"speedOfTravel": 49.9955,
"speedOfTravelUnit": "mph",
"roadType": "major road rural",
"segmentDirection": "bidirectional",
"startJunctionType": "",
"endJunctionType": "Other",
"isRoundabout": false,
"isTollRoad": false,
"geometry": {
"type": "LineString",
"crs": {
"type": "name",
"properties": {
"name": "epsg:4326"
}
},
"coordinates": [[…]]
}
},
{
"segmentID": "46ed0e49:d9a7dc",
"primaryName": "VA-631",
"primaryNameLanguage": "en",
"alternateNameList": [{
"alternateName": "Lloyds Rd",
"language": "en"
}],
"segmentLength": 1.198,
"segmentLengtUnit": "mi",
"timeTaken": 1.433,
"timeUnit": "min",
"turnAngle": 0.0,
"turnAngleUnit": "degree",
"compassDirection": "",
"speedOfTravel": 49.9955,
"speedOfTravelUnit": "mph",
"roadType": "major road rural",
"segmentDirection": "bidirectional",
"startJunctionType": "Other",
"endJunctionType": "",
"isRoundabout": false,
"isTollRoad": false,
"pointsInSegment": {
"type": "LineString",
"crs": {
"type": "name",
"properties": {
"name": "epsg:4326"
}
},
"coordinates": [[…]]
}
}]
Renvoie des données de segment indiquant un segmentID.
http://www.pb.com/rest/Spatial/erm/databases/usroutedatabase/segments/aa18eb33:1b7bbe.json?distanceUnits=mi
Réponse
[{
"segmentID": "aa18eb33:1b7bbe",
"primaryName": "VA-631",
"primaryNameLanguage": "en",
"alternateNames": [{
"alternateName": "Lloyds Rd",
"language": "en"
},
{
"alternateName": "VA-631",
"language": "en"
}],
"segmentLength": 4.954,
"segmentLengthUnit": "mi",
"timeTaken": 5.9333,
"timeUnit": "min",
"turnAngle": 0.0,
"turnAngleUnit": "deg",
"compassDirection": "",
"speedOfTravel": 49.9955,
"speedOfTravelUnit": "mph",
"roadType": "major road rural",
"segmentDirection": "bidirectional",
"startJunctionType": "",
"endJunctionType": "Other",
"isRoundabout": false,
"isTollRoad": false
}