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.

Anmerkung: Die Antwort vom REST-Dienst erscheint im JSON-Format. Wenn eine Anforderung ungültige Abfrageparameter in der GET URL oder eine ungültige Nutzlast für POST enthält, wird eine gesammelte Fehlerantwort in einem JSON-Array zurückgegeben. Der Knoten value in der Antwort-JSON ist veraltet. Bei der Fehlerüberprüfung sollte nur der Knoten errors verwendet werden.

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:

None
Keine geometrische Darstellung eines Segments wird zurückgegeben. Standard, wenn keine Angaben vorhanden sind.
End
Die einzelnen Segmente der Route werden nur mit den eigenen Endpunkten in einer LineString zurückgegeben.
All
Die einzelnen Segmente werden mit allen zugehörigen Shape-Punkten in einer LineString zurückgegeben. Die LineString kann als Überlagerung in einer Karte verwendet werden.

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
}