X4 Produktdokumentation

Operation: GetDirections

Mit Operation GetDirections lässt sich die Route zwischen einem Start- und Zielpunkt mit beliebig vielen Wegpunkten ermitteln.

Input

Für Operation GetDirections erwartet der Adapter eine XML-Input-Struktur nach folgendem Muster, die Start-, Ziel und beliebige Wegpunkte als Dezimalkoordinaten oder Adresse enthält:

<Routing>
	<Origin>
		<!-- Address or GeoDecimal -->
		<Address>
			<Street><!--Street and number--></Street>
			<ZIP><!--ZIP code--></ZIP>
			<City><!--Place--></City>
			<Country><!--Country--></Country>
		</Address>
	</Origin>
	<Waypoints>
		<!-- Any number of waypoints -->
		<!-- Address or GeoDecimal -->
		<Waypoint>
			<Address>
				<Location><!--Location--></Location>
				<City><!--Place--></City>
			</Address>
		</Waypoint>
	</Waypoints>
	<Destination>
		<!-- Address or GeoDecimal -->
		<GeoDecimal>
			<Latitude><!--Latitude--></Latitude>
			<Longitude><!--Longitude--></Longitude>
		</GeoDecimal>
	</Destination>
</Routing>

Output

Für Operation GetDirections wird ein XML- oder JSON-Dokument ausgegeben, das eine für PKW berechnete Route beschreibt. Falls mehrere Routenvarianten bestehen, wird die schnellste Route ausgegeben.