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, Adresse oder im GooglePoint-Format enthält:

<GoogleRouting xmlns:exslt="http://exslt.org/common">
   <Origin>
      <!--Dezimalkoordinate, Adresse/POI oder GooglePoint-->
   </Origin>
   <Waypoints>
      <!-- Any number of waypoints -->
      <Waypoint>
         <!--Dezimalkoordinate, Adresse/POI oder GooglePoint-->
      </Waypoint>
   </Waypoints>
   <Destination>
      <!--Dezimalkoordinate, Adresse/POI oder GooglePoint-->
   </Destination>
</GoogleRouting>

Adressen werden in folgender XML-Struktur angegeben:

   <Address>
      <Street><!--Straße und Hausnummer--></Street>
      <ZIP><!--Postleitzahl--></ZIP>
      <City><!--Ort--></City>
      <Country><!--Land--></Country>
   </Address>

GooglePoints werden in folgendem XML-Element angegeben:

     <Address>
      <Location><!--Point of Interest--></Location>
      <City><!--Ort</City>
   </Address>

GooglePoints werden in folgendem XML-Element angegeben:

    <GooglePoint><!--GooglePoint-Code--></GooglePoint>

Dezimalkoordinaten werden in folgender XML-Struktur angegeben:

<GeoDecimal>
   <Latitude><!--NN.NNNNNNN--></Latitude>
   <Longitude><!--EE.EEEEEEE--></Longitude>
</GeoDecimal>

Output

Für Operation GetDirections wird ein XML- oder JSON-Dokument ausgegeben, das eine für PKW berechnete Route gemäß http://code.google.com/intl/en/apis/maps/documentation/directions/#XML beschreibt. Falls mehrere Routenvarianten bestehen, wird die schnellste Route ausgegeben.