TrackService Web Service

TrackService

Click here for a complete list of operations.

CalculateRoute

Turn-by-turn directions and route maps for a single route.

Test

The test form is only available for requests from the local machine.

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>
            <DeliveryNonStop>boolean</DeliveryNonStop>
            <KeepSameOrder>boolean</KeepSameOrder>
            <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>
            <TimeConstraintArrival2>dateTime</TimeConstraintArrival2>
            <TimeConstraintDeparture2>dateTime</TimeConstraintDeparture2>
            <TimeEstimatedArrival>dateTime</TimeEstimatedArrival>
            <LocationType>Midway or Start or Finish or Delivery or MidwayDrop or Break</LocationType>
            <CanArriveEarly>boolean</CanArriveEarly>
            <Distance>double</Distance>
            <Time>int</Time>
            <Conditions>string</Conditions>
          </Location>
          <Location>
            <MatchCode>None or Poor or Approx or Good or Exact</MatchCode>
            <Name>string</Name>
            <Delivery>string</Delivery>
            <DeliveryNonStop>boolean</DeliveryNonStop>
            <KeepSameOrder>boolean</KeepSameOrder>
            <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>
            <TimeConstraintArrival2>dateTime</TimeConstraintArrival2>
            <TimeConstraintDeparture2>dateTime</TimeConstraintDeparture2>
            <TimeEstimatedArrival>dateTime</TimeEstimatedArrival>
            <LocationType>Midway or Start or Finish or Delivery or MidwayDrop or Break</LocationType>
            <CanArriveEarly>boolean</CanArriveEarly>
            <Distance>double</Distance>
            <Time>int</Time>
            <Conditions>string</Conditions>
          </Location>
        </Locations>
        <RouteOptions>
          <RoutingService>NetRoad or TrackRoad or Bing</RoutingService>
          <DistanceUnit>Mile or Kilometer</DistanceUnit>
          <RouteOptimize>MinimizeTime or MinimizeDistance</RouteOptimize>
          <Culture>string</Culture>
          <MapSize>
            <Width>int</Width>
            <Height>int</Height>
          </MapSize>
          <RouteColor>
            <A>unsignedByte</A>
            <R>unsignedByte</R>
            <G>unsignedByte</G>
            <B>unsignedByte</B>
          </RouteColor>
          <MapCenter>
            <Latitude>double</Latitude>
            <Longitude>double</Longitude>
          </MapCenter>
          <HideStops>boolean</HideStops>
          <ZoomLevel>int</ZoomLevel>
        </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>
          <Map>string</Map>
        </Route>
      </CalculateRouteResult>
    </CalculateRouteResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 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: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Header>
    <SessionIDHeader xmlns="http://TrackService.TrackRoad.com/">
      <SessionID>string</SessionID>
    </SessionIDHeader>
  </soap12:Header>
  <soap12: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>
            <DeliveryNonStop>boolean</DeliveryNonStop>
            <KeepSameOrder>boolean</KeepSameOrder>
            <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>
            <TimeConstraintArrival2>dateTime</TimeConstraintArrival2>
            <TimeConstraintDeparture2>dateTime</TimeConstraintDeparture2>
            <TimeEstimatedArrival>dateTime</TimeEstimatedArrival>
            <LocationType>Midway or Start or Finish or Delivery or MidwayDrop or Break</LocationType>
            <CanArriveEarly>boolean</CanArriveEarly>
            <Distance>double</Distance>
            <Time>int</Time>
            <Conditions>string</Conditions>
          </Location>
          <Location>
            <MatchCode>None or Poor or Approx or Good or Exact</MatchCode>
            <Name>string</Name>
            <Delivery>string</Delivery>
            <DeliveryNonStop>boolean</DeliveryNonStop>
            <KeepSameOrder>boolean</KeepSameOrder>
            <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>
            <TimeConstraintArrival2>dateTime</TimeConstraintArrival2>
            <TimeConstraintDeparture2>dateTime</TimeConstraintDeparture2>
            <TimeEstimatedArrival>dateTime</TimeEstimatedArrival>
            <LocationType>Midway or Start or Finish or Delivery or MidwayDrop or Break</LocationType>
            <CanArriveEarly>boolean</CanArriveEarly>
            <Distance>double</Distance>
            <Time>int</Time>
            <Conditions>string</Conditions>
          </Location>
        </Locations>
        <RouteOptions>
          <RoutingService>NetRoad or TrackRoad or Bing</RoutingService>
          <DistanceUnit>Mile or Kilometer</DistanceUnit>
          <RouteOptimize>MinimizeTime or MinimizeDistance</RouteOptimize>
          <Culture>string</Culture>
          <MapSize>
            <Width>int</Width>
            <Height>int</Height>
          </MapSize>
          <RouteColor>
            <A>unsignedByte</A>
            <R>unsignedByte</R>
            <G>unsignedByte</G>
            <B>unsignedByte</B>
          </RouteColor>
          <MapCenter>
            <Latitude>double</Latitude>
            <Longitude>double</Longitude>
          </MapCenter>
          <HideStops>boolean</HideStops>
          <ZoomLevel>int</ZoomLevel>
        </RouteOptions>
      </specification>
    </CalculateRoute>
  </soap12:Body>
</soap12:Envelope>

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

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12: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>
          <Map>string</Map>
        </Route>
      </CalculateRouteResult>
    </CalculateRouteResponse>
  </soap12:Body>
</soap12:Envelope>