Get ETA OOR

Contents

The GetETAOutOfRouteReport operation returns the out of route(Oor) mileage and estimated time of arrival(ETA) given a collection of out of route locations, for a defined route.

Schema

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <SOAP-ENV:Header>
    <m:AuthHeader xmlns:m="http://www.alk.com">
      <m:Authorization>String</m:Authorization>
      <m:Date>String</m:Date>
    </m:AuthHeader>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <m:GetETAOutOfRouteReport xmlns:m="https://pcmiler.alk.com/APIs/v1.0">
      <m:Request>
        <m:Header>
          <m:DataVersion>String</m:DataVersion>
          <m:RequestType>String</m:RequestType>
        </m:Header>
        <m:Body>
          <m:RouteID>String</m:RouteID>
          <m:Origin>
            <m:Address>
              <m:StreetAddress>String</m:StreetAddress>
              <m:City>String</m:City>
              <m:State>String</m:State>
              <m:Zip>String</m:Zip>
              <m:County>String</m:County>
              <m:Country>String</m:Country>
              <m:SPLC>String</m:SPLC>
              <m:CountryPostalFilter>US</m:CountryPostalFilter>
              <m:AbbreviationFormat>FIPS</m:AbbreviationFormat>
            </m:Address>
            <m:Coords>
              <m:Lat>String</m:Lat>
              <m:Lon>String</m:Lon>
            </m:Coords>
            <m:Region>Unknown</m:Region>
            <m:Label>String</m:Label>
            <m:PlaceName>String</m:PlaceName>
            <m:Costs>
              <m:CostOfStop>3.14159265358979E0</m:CostOfStop>
              <m:HoursPerStop>3.14159265358979E0</m:HoursPerStop>
              <m:Loaded>true</m:Loaded>
              <m:OnDuty>true</m:OnDuty>
              <m:UseOrigin>true</m:UseOrigin>
            </m:Costs>
            <m:IsViaPoint>true</m:IsViaPoint>
          </m:Origin>
          <m:Destination>
            <m:Address>
              <m:StreetAddress>String</m:StreetAddress>
              <m:City>String</m:City>
              <m:State>String</m:State>
              <m:Zip>String</m:Zip>
              <m:County>String</m:County>
              <m:Country>String</m:Country>
              <m:SPLC>String</m:SPLC>
              <m:CountryPostalFilter>US</m:CountryPostalFilter>
              <m:AbbreviationFormat>FIPS</m:AbbreviationFormat>
            </m:Address>
            <m:Coords>
              <m:Lat>String</m:Lat>
              <m:Lon>String</m:Lon>
            </m:Coords>
            <m:Region>Unknown</m:Region>
            <m:Label>String</m:Label>
            <m:PlaceName>String</m:PlaceName>
            <m:Costs>
              <m:CostOfStop>3.14159265358979E0</m:CostOfStop>
              <m:HoursPerStop>3.14159265358979E0</m:HoursPerStop>
              <m:Loaded>true</m:Loaded>
              <m:OnDuty>true</m:OnDuty>
              <m:UseOrigin>true</m:UseOrigin>
            </m:Costs>
            <m:IsViaPoint>true</m:IsViaPoint>
          </m:Destination>
          <m:CurrentLocations>
            <m:StopLocation>
              <m:Address>
                <m:StreetAddress>String</m:StreetAddress>
                <m:City>String</m:City>
                <m:State>String</m:State>
                <m:Zip>String</m:Zip>
                <m:County>String</m:County>
                <m:Country>String</m:Country>
                <m:SPLC>String</m:SPLC>
                <m:CountryPostalFilter>US</m:CountryPostalFilter>
                <m:AbbreviationFormat>FIPS</m:AbbreviationFormat>
              </m:Address>
              <m:Coords>
                <m:Lat>String</m:Lat>
                <m:Lon>String</m:Lon>
              </m:Coords>
              <m:Region>Unknown</m:Region>
              <m:Label>String</m:Label>
              <m:PlaceName>String</m:PlaceName>
              <m:Costs>
                <m:CostOfStop>3.14159265358979E0</m:CostOfStop>
                <m:HoursPerStop>3.14159265358979E0</m:HoursPerStop>
                <m:Loaded>true</m:Loaded>
                <m:OnDuty>true</m:OnDuty>
                <m:UseOrigin>true</m:UseOrigin>
              </m:Costs>
              <m:IsViaPoint>true</m:IsViaPoint>
            </m:StopLocation>
          </m:CurrentLocations>
          <m:RoutingOptions>
            <m:BordersOpen>true</m:BordersOpen>
            <m:ClassOverrides>None</m:ClassOverrides>
            <m:DistanceUnits>Miles</m:DistanceUnits>
            <m:FuelRoute>true</m:FuelRoute>
            <m:HazMatType>None</m:HazMatType>
            <m:HighwayOnly>true</m:HighwayOnly>
            <m:HubRouting>true</m:HubRouting>
            <m:OverrideRestrict>true</m:OverrideRestrict>
            <m:RouteOptimization>None</m:RouteOptimization>
            <m:RoutingType>Practical</m:RoutingType>
            <m:TollDiscourage>true</m:TollDiscourage>
            <m:TruckCfg>
              <m:Axles>0</m:Axles>
              <m:Height>String</m:Height>
              <m:LCV>true</m:LCV>
              <m:Length>String</m:Length>
              <m:Units>English</m:Units>
              <m:Weight>String</m:Weight>
              <m:Width>String</m:Width>
            </m:TruckCfg>
            <m:UseAvoidsAndFavors>true</m:UseAvoidsAndFavors>
            <m:VehicleType>Truck</m:VehicleType>
          </m:RoutingOptions>
          <m:ReportingOptions>
            <m:EstimatedTimeOptions>
              <m:ETAETD>Arrival</m:ETAETD>
              <m:DateOption>Current</m:DateOption>
              <m:DateAndTime>
                <m:CalendarDate>String</m:CalendarDate>
                <m:DayOfWeek>Sunday</m:DayOfWeek>
                <m:TimeOfDay>String</m:TimeOfDay>
                <m:TimeZone>Local</m:TimeZone>
              </m:DateAndTime>
            </m:EstimatedTimeOptions>
            <m:ExchangeRate>3.14159265358979E0</m:ExchangeRate>
            <m:FuelUnits>Gallons</m:FuelUnits>
            <m:IncludeFerryDistance>true</m:IncludeFerryDistance>
            <m:Language>ENUS</m:Language>
            <m:RouteCosts>
              <m:CostTimeEmpty>3.14159265358979E0</m:CostTimeEmpty>
              <m:CostTimeLoaded>3.14159265358979E0</m:CostTimeLoaded>
              <m:FuelEconomyEmpty>3.14159265358979E0</m:FuelEconomyEmpty>
              <m:FuelEconomyLoaded>3.14159265358979E0</m:FuelEconomyLoaded>
              <m:GreenHouseGas>3.14159265358979E0</m:GreenHouseGas>
              <m:OtherCostPerDistUnitLoaded>3.14159265358979E0</m:OtherCostPerDistUnitLoaded>
              <m:OtherCostPerDistanceUnitEmpty>3.14159265358979E0</m:OtherCostPerDistanceUnitEmpty>
              <m:PricePerFuelUnit>3.14159265358979E0</m:PricePerFuelUnit>
              <m:TruckStyle>None</m:TruckStyle>
            </m:RouteCosts>
            <m:TimeCosts>
              <m:BreakInterval>3.14159E0</m:BreakInterval>
              <m:BreakLength>3.14159E0</m:BreakLength>
              <m:BorderWait>3.14159E0</m:BorderWait>
              <m:DepartTime>
                <m:Hour>0</m:Hour>
                <m:Minute>0</m:Minute>
                <m:AmPm>Military</m:AmPm>
              </m:DepartTime>
              <m:RemainingHoursOfService>3.14159E0</m:RemainingHoursOfService>
            </m:TimeCosts>
            <m:TollCurrency>US</m:TollCurrency>
            <m:TollDiscount>String</m:TollDiscount>
            <m:UseCustomRoadSpeeds>true</m:UseCustomRoadSpeeds>
            <m:UseTollData>true</m:UseTollData>
            <m:UseTraffic>true</m:UseTraffic>
          </m:ReportingOptions>
        </m:Body>
      </m:Request>
    </m:GetETAOutOfRouteReport>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

ETAOutOfRoute Request

Request Body Elements

Represents a request to perform out of route mileage and estimated time of arrival from supplied current locations for a defined route. Request body gets or sets the body of the request, which contains information needed to perform the operation.

ElementDefinitionRequired
CurrentLocationsA list <> of StopLocation object. Gets or sets a collection of StopLocation objects each of which represent the truck's current location.

Usage:List<StopLocation> oorStops = new List<StopLocation>();

StopLocation loc = new StopLocation()

{ Coord = new Coordinates { Lat ="40353828", Lon="-74610884" } };

oorStops.Add(loc);

CurrentLocation = oorStops.ToArrat();

Y
DestinationA StopLocation object. Gets or sets the trip's destination.

Usage:StopLocation tripDest = new StopLocation() { Address = new Address() };
Y
OriginA StopLocation object. Gets or sets the trip's origin.

Usage:StopLocation tripOrigin = new StopLocation() { Address = new Address() };
Y
ReportingOptionsA ReportOptions object. Gets or sets the reporting options used in creating the output data.

Usage:ReportOptions repOption = new ReportOptions()

{

EstimatedTimeOptions = timeOpts,

ExchangeRate = 1.5,

ExchangeRateSpecified = true,

};

N
RouteIDA string value. Gets or sets a unique identifier for the route which will be visible in the output report generated. Inherited from Route.

Usage:RouteID = "ETA Out of Route Report Test";
N
RoutingOptionsA RouteOptions object. Gets or sets the routing options for the route calculations.

Usage:RouteOptions tripOption = new RouteOptions()

{

HighwayOnly = true,

HighwayOnlySpecified = true,

VehicleType = VehicleType.LightTruck,

VehicleTypeSpecified = true,

ClassOverrides = ClassOverridesType.FiftyThreeFoot,

ClassOverridesSpecified = True,

};

N

Calling ETA OOR Report

StopLocation tripOrigin = new StopLocation() { Address = new Address() };
      StopLocation tripDest = new StopLocation() { Address = new Address() };
      tripOrigin.Address.City = "Princeton";
      tripOrigin.Address.Zip = "08540";
      tripOrigin.Region = DataRegion.NA;
      tripOrigin.RegionSpecified = true;

      tripDest.Address.City = "Monmouth Junction";
      tripDest.Address.Zip = "08852";
      tripDest.Region = DataRegion.NA;
      tripDest.RegionSpecified = true;

      Coordinates coords = new Coordinates()
      {
          Lat = "40353828",
          Lon = "-74610884"
      };
      StopLocation[] loc = new StopLocation[2] ;
      loc[0] = new StopLocation() { Coords = new Coordinates() { Lat = "40353828", Lon = "74610884" } };
      loc[1] = new StopLocation() {Address = new Address() {Zip = "19123"}, Region = DataRegion.NA, RegionSpecified = true};

      // Set route options
      RouteOptions tripOption = new RouteOptions();
      tripOption.HighwayOnly = true;
      tripOption.HighwayOnlySpecified = true;
      tripOption.VehicleType = VehicleType.LightTruck;
      tripOption.VehicleTypeSpecified = true;
      tripOption.ClassOverrides = ClassOverrideType.FiftyThreeFoot;

      ReportOptions repOption = new ReportOptions()
      {
          EstimatedTimeOptions = timeOpts,
          ExchangeRate = 1.5,
          ExchangeRateSpecified = true,
          FuelUnits = VolumeUnits.Gallons,
          FuelUnitsSpecified = true,
          IncludeFerryDistance = true,
          IncludeFerryDistanceSpecified = true,
          Language = LanguageType.DE,
          LanguageSpecified = true,
          RouteCosts =routeCosts,
          TimeCosts = timeCosts,
          TollCurrency = Currency.US,
          TollCurrencySpecified = true,
          TollDiscount = "All",
          UseCustomRoadSpeeds = false,
          UseCustomRoadSpeedsSpecified =true,
          UseTollData = true,
          UseTollDataSpecified = true,
      };

      // Create the request
      ETAOutOfRouteRequestBody body = new ETAOutOfRouteRequestBody();
      body.RouteID = "ETA Out of Route Report Test";
      body.Origin = tripOrigin;
      body.Destination = tripDest;
      body.CurrentLocations = loc;
      body.ReportingOptions = repOption;
      body.RoutingOptions = tripOption;

      ETAOutOfRouteRequest request = new ETAOutOfRouteRequest()
      {
          Header = new RequestHeader() { DataVersion =  DataVersion.ToString(), RequestType = "GetETAOutOfRouteReport" },
          Body = body
      };
      // Create the authentication and authorization header
      AuthHeader soapHeader =  GenerateAuthHeader(APIName);
      // Create the service client
      ServiceClient service = new  ServiceClient();

      // Call API
      ReportResponse response = service.GetETAOutOfRouteReport(soapHeader, request);

Request

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
   <h:AuthHeader xmlns="http://www.alk.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:h="http://www.alk.com">
      <Authorization>A77097D2D202A743BB1660E15794D7CA</Authorization>
      <Date>Wed, 10 Sep 2014 19:35:41 GMT</Date>
    </h:AuthHeader>
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <GetETAOutOfRouteReport xmlns="https://pcmiler.alk.com/APIs/v1.0">
      <Request>
        <Header>
          <DataVersion>current</DataVersion>
          <RequestType>GetETAOutOfRouteReport</RequestType>
        </Header>
        <Body>
          <RouteID>ETA Out of Route Report Test</RouteID>
          <Origin>
            <Address>
              <City>Princeton</City>
              <Zip>08540</Zip>
            </Address>
            <Region>NA</Region>
          </Origin>
          <Destination>
            <Address>
              <City>Monmouth Junction</City>
              <Zip>08852</Zip>
             </Address>
             <Region>NA</Region>
            <Costs>
              <CostOfStop>5</CostOfStop>
              <HoursPerStop>1</HoursPerStop>
              <Loaded>true</Loaded>
              <OnDuty>true</OnDuty>
              <UseOrigin>false</UseOrigin>
            </Costs>
          </Destination>
          <CurrentLocations>
            <StopLocation>
              <Coords>
                <Lat>40353828</Lat>
                <Lon>-74610884</Lon>
              </Coords>
            </StopLocation>
            <StopLocation>
              <Address>
                <Zip>19123</Zip>
              </Address>
              <Region>NA</Region>
            </StopLocation>
          </CurrentLocations>
          <RoutingOptions>
            <ClassOverrides>FiftyThreeFoot</ClassOverrides>
            <HighwayOnly>true</HighwayOnly>
            <TruckCfg xsi:nil="true" />
            <VehicleType>LightTruck</VehicleType>
          </RoutingOptions>
          <ReportingOptions>
            <EstimatedTimeOptions>
              <ETAETD>Arrival</ETAETD>
              <DateOption>Specific</DateOption>
              <DateAndTime>
                <CalendarDate>10/10/2014</CalendarDate>
                <DayOfWeek>Friday</DayOfWeek>
                <TimeOfDay>12:00</TimeOfDay>
                <TimeZone>Eastern</TimeZone>
              </DateAndTime>
            </EstimatedTimeOptions>
            <ExchangeRate>1.5</ExchangeRate>
            <FuelUnits>Gallons</FuelUnits>
            <IncludeFerryDistance>true</IncludeFerryDistance>
            <Language>DE</Language>
            <RouteCosts>
              <CostTimeEmpty>5</CostTimeEmpty>
              <CostTimeLoaded>15</CostTimeLoaded>
              <FuelEconomyEmpty>1</FuelEconomyEmpty>
              <FuelEconomyLoaded>16</FuelEconomyLoaded>
              <GreenHouseGas>1</GreenHouseGas>
              <OtherCostPerDistUnitLoaded>2</OtherCostPerDistUnitLoaded>
              <OtherCostPerDistanceUnitEmpty>5</OtherCostPerDistanceUnitEmpty>
              <PricePerFuelUnit>3.95</PricePerFuelUnit>
              <TruckStyle>FiftyThreeSemiTrailer</TruckStyle>
            </RouteCosts>
            <TollCurrency>US</TollCurrency>
            <TollDiscount>All</TollDiscount>
            <UseCustomRoadSpeeds>false</UseCustomRoadSpeeds>
            <UseTollData>true</UseTollData>
            <UseTraffic>true</UseTraffic>
          </ReportingOptions>
        </Body>
      </Request>
    </GetETAOutOfRouteReport>
  </s:Body>
</s:Envelope>

Response

Represents an ETA Out of Route report which presents information related to out of route stops.

ETAOutOfRouteReport Response Body Members

ElementDefinition
DestinationA GeocodeOutputLocation object. Gets or sets the trip’s destination.
OriginA GeocodeOutputLocation object. Gets or sets the trip’s origin.
ReportLinesA list of objects. Gets or sets the report lines for the report.
DestinationGets or sets the unique route identifier that was supplied during the request.(Inherited from Report)

OutOfRouteReportLine Members

ElementDefinition
CurrentLocationA GeocodeOutputLocation object. Gets or sets the geocoded output location containing the address information of the vehicle’s current position.
LCostMileA string value. Gets or sets the leg cost per mile.
LHoursA string value. Gets or sets the leg hours.
LMilesA string value. Gets or sets the leg miles.
LTollsA string value. Gets or sets the leg tolls.
OORMILEA string value. Gets or sets the estimated out-of-route miles.
TCostMileA string value. Gets or sets the total cost per mile.
THoursA string value. Gets or sets the total hours.
TMilesA string value. Gets or sets the total miles.
TTollsA string value. Gets or sets the total tolls.

Sample Response

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header />
  <s:Body>
    <GetETAOutOfRouteReportResponse xmlns="https://pcmiler.alk.com/APIs/v1.0">
      <GetETAOutOfRouteReportResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Header>
          <Type>GetETAOutOfRouteReport</Type>
          <Success>true</Success>
          <DataVersion>28.0.24.5492</DataVersion>
          <Errors />
        </Header>
        <Body>
          <Reports>
            <Report i:type="ETAOutOfRouteReport">
              <RouteID>ETA Out of Route Report Test</RouteID>
              <Origin>
                <Address>
                  <StreetAddress />
                  <City>Princeton</City>
                  <State>NJ</State>
                  <Zip>08540</Zip>
                  <County>Mercer</County>
                  <Country i:nil="true" />
                  <SPLC i:nil="true" />
                  <CountryPostalFilter>US</CountryPostalFilter>
                  <AbbreviationFormat>FIPS</AbbreviationFormat>
                  <CountryAbbreviation>US</CountryAbbreviation>
                </Address>
                <Coords>
                  <Lat>40.348727</Lat>
                  <Lon>-74.659049</Lon>
                </Coords>
                <Region>NA</Region>
                <Label />
                <PlaceName />
                ```
Edit on GitHub