CalculateRoute

Returns turn-by-turn directions


SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TrackService.asmx HTTP/1.1
Host: trackservice.trackroad.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://TrackService.TrackRoad.com/CalculateRoute"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <SessionIDHeader xmlns="http://TrackService.TrackRoad.com/">
      <SessionID>string</SessionID>
    </SessionIDHeader>
  </soap:Header>
  <soap:Body>
    <CalculateRoute xmlns="http://TrackService.TrackRoad.com/">
      <specification>
        <Locations>
          <Location>
            <MatchCode>None or Poor or Approx or Good or Exact</MatchCode>
            <Name>string</Name>
            <Delivery>string</Delivery>
            <Vehicle>string</Vehicle>
            <Description>string</Description>
            <Phone>string</Phone>
            <LatLong xsi:nil="true" />
            <Address xsi:nil="true" />
            <Priority>int</Priority>
            <Wait>int</Wait>
            <Volume>double</Volume>
            <Weight>double</Weight>
            <Skids>int</Skids>
            <TimeConstraintArrival>dateTime</TimeConstraintArrival>
            <TimeConstraintDeparture>dateTime</TimeConstraintDeparture>
            <LocationType>Midway or Start or Finish or Delivery or MidwayDrop</LocationType>
            <CanArriveEarly>boolean</CanArriveEarly>
            <Distance>double</Distance>
            <Time>int</Time>
          </Location>
          <Location>
            <MatchCode>None or Poor or Approx or Good or Exact</MatchCode>
            <Name>string</Name>
            <Delivery>string</Delivery>
            <Vehicle>string</Vehicle>
            <Description>string</Description>
            <Phone>string</Phone>
            <LatLong xsi:nil="true" />
            <Address xsi:nil="true" />
            <Priority>int</Priority>
            <Wait>int</Wait>
            <Volume>double</Volume>
            <Weight>double</Weight>
            <Skids>int</Skids>
            <TimeConstraintArrival>dateTime</TimeConstraintArrival>
            <TimeConstraintDeparture>dateTime</TimeConstraintDeparture>
            <LocationType>Midway or Start or Finish or Delivery or MidwayDrop</LocationType>
            <CanArriveEarly>boolean</CanArriveEarly>
            <Distance>double</Distance>
            <Time>int</Time>
          </Location>
        </Locations>
        <RouteOptions>
          <DistanceUnit>Mile or Kilometer</DistanceUnit>
          <RouteOptimize>MinimizeTime or MinimizeDistance</RouteOptimize>
          <Culture>string</Culture>
        </RouteOptions>
      </specification>
    </CalculateRoute>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <CalculateRouteResponse xmlns="http://TrackService.TrackRoad.com/">
      <CalculateRouteResult>
        <Route>
          <Distance>double</Distance>
          <Time>int</Time>
          <RouteLegs>
            <RouteLeg xsi:nil="true" />
            <RouteLeg xsi:nil="true" />
          </RouteLegs>
          <Points>
            <LatLong xsi:nil="true" />
            <LatLong xsi:nil="true" />
          </Points>
        </Route>
      </CalculateRouteResult>
    </CalculateRouteResponse>
  </soap:Body>
</soap:Envelope>