Driver->GetDataRanges

Last updated
Save as PDF

GetDataRanges (Driver Function)

Returns a list of driver IDs and the first and last status change for each driver.

At most 1000 drivers at a time will be returned. On the first call, omit or pass an empty string as the driver ID. On subsequent calls, pass the last driver ID returned from the previous call so that the next 1000 drivers are returned. Continue this until no drivers are returned. Drivers are always returned in alphabetical order based on the driver ID. The FirstStatusChange for a driver is the earliest status change as of the time of the call. The LastStatusChange for a driver is the last status change as of the time of the call. This will be the start time of his current duty status.

XML Request

The GetDataRanges function takes the following input parameters:

Parameter	Type	Description
LastDriverId	String	The last driver ID returned from the prior call. Do not specify this on the first call.

  
<soap:Body>  
    <GetDataRanges xmlns="http://www.qualcomm.com">  
        <request>  
            <LastDriverId>string</LastDriverId>  
        </request>  
    </GetDataRanges>  
</soap:Body>

XML Response

The XML response will have a <DriverDataRanges> tag that contains a sequence of <DriverDataRange> tags. Each <DriverDataRange> has the following values:

Parameter	Type	Description
DriverId	string	The driver's ID
FirstStatusChange	dateTime	The earliest status change for the driver in GMT (truncated to the minute)
LastStatusChange	dateTime	The latest status change for the driver in GMT (truncated to the minute)

  
<soap:Body>  
    <GetDataRangesResponse xmlns="http://www.qualcomm.com">  
        <GetDataRangesResult>  
            <DriverDataRanges>  
                <DriverDataRange>  
                    <DriverId>string</DriverId>  
                    <FirstStatusChange>dateTime</FirstStatusChange>  
                    <LastStatusChange>dateTime</LastStatusChange>  
                </DriverDataRange>  
                <DriverDataRange>  
                    <DriverId>string</DriverId>  
                    <FirstStatusChange>dateTime</FirstStatusChange>  
                    <LastStatusChange>dateTime</LastStatusChange>  
                </DriverDataRange>  
            </DriverDataRanges>  
        </GetDataRangesResult>  
    </GetDataRangesResponse>  
</soap:Body>