GetSegmentData
Beschreibung
Der GetSegmentData-Dienst gibt Segmentinformationen für einen Punkt oder eine Segment-ID zurück. Wenn ein Punkt angegeben ist, werden die am nächsten liegenden Routensegmente zurückgegeben. Wenn eine Segment-ID angegeben ist, werden die Routendaten für das angegebene Routensegment zurückgegeben.
URL-Format von HTTP-GET-Anforderungen
Für HTTP-GET-Anforderungen wird das folgende Format verwendet. Die HTTP-GET-Anforderungen sind für die Rückgabe von Segmentdaten an einem Punkt oder die Rückgabe von Segmentdaten für eine Segment-ID unterschiedlich.
Rückgabe von Daten für ein Segment an einem angegebenen Punkt:
HTTP GET /rest/Spatial/erm/databases/dbsource/segments.json?point=x,y,srsName&query_parameters
Rückgabe von Daten für ein angegebenes Segment:
HTTP GET /rest/Spatial/erm/databases/dbsource/segments/segmentID.json?query_parameters
Dabei steht dbsource für den Namen der Datenbank, die die für die Route zu verwendenden Daten enthält. Verwenden Sie den Datenbanknamen, der im Routing-Datenbankressourcentool des Enterprise Routing-Moduls angegeben ist. segmentID ist der Bezeichner des Segments, an das Sie die Daten zurückgeben möchten.
Abfrageparameter
Bei diesem Vorgang werden die folgenden Abfrageparameter verwendet.
Parameter | Typ | Erforderlich | Beschreibung |
---|---|---|---|
destinationSrs | Zeichenfolge | nein | Das Koordinatensystem für die Rückgabe der Segmentdaten und die resultierende Geometry. Standardmäßig wird das Koordinatensystem der Daten verwendet. |
distanceUnit | Zeichenfolge | nein | Die Einheiten für die zurückgelegte Strecke. Standardwert ist m (Meter). Verfügbare Werte sind: m (Meter), km (Kilometer), yd (Yard), ft (Fuß), mi (Meile). |
timeUnit | Zeichenfolge | nein | Die Einheiten für die Rücklaufzeit. Standardmäßig ist min (Minute) ausgewählt. Verfügbare Werte sind: min (Minute), msec (Millisekunde), s (Sekunde), h (Stunde). |
velocityUnit | Zeichenfolge | nein | Die Einheiten für die Rücklaufgeschwindigkeit. Standardmäßig ist „mph“ (Meilen pro Stunde) festgelegt. Verfügbare Werte sind: mph (Meilen pro Stunde) und kph (Kilometer pro Stunde). |
angularUnit | Zeichenfolge | nein | Die Wohneinheiten, für die Drehwinkel zurückgegeben werden sollen. Standardmäßig ist „deg“ (Grad) festgelegt. Verfügbare Werte sind: deg (Grad), rad (Radiant), minute (Minute), sec (Sekunde), grad (Grad). |
segmentGeometryStyle | Zeichenfolge | nein |
Das Format der Geometry, in dem ein Segment der Route dargestellt wird. Der Standardwert ist „None“. Geben Sie diesen Parameter an, wenn Geometry-Daten des Segments zurückgegeben werden müssen. Bei der Angabe von Wegbeschreibungen sind folgende Optionen verfügbar:
|
Beispiele
Geben Sie Segmentdaten zurück, die einen Punkt angeben.
http://www.pb.com/rest/Spatial/erm/databases/usroutedatabase/segments.json?point=-77,38,epsg:4326&segmentGeometryStyle=all
Antwort
[{
"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": [[…]]
}
}]
Geben Sie Segmentdaten zurück, die eine segmentID angeben.
http://www.pb.com/rest/Spatial/erm/databases/usroutedatabase/segments/aa18eb33:1b7bbe.json?distanceUnits=mi
Antwort
[{
"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
}