Introduction

DRTrack APIs are built using Microsoft Windows Communication Foundation (WCF) framework that is SOAP based and implements WS-Security standards.

The service includes a full of set of APIs for data regarding orders, accounts, routes, and more. You can view the full WSDL here.

A unique URL is provided for each customer to access the service.

Testing the Service

To test the DRTrack service, you will need to create a client and use it to call the service.

class Test
{
    static void Main()
    {
        DRTrackWebServiceClient client = new DRTrackWebServiceClient();
        // Use the 'client' variable to call operations on the service.
        // Always close the client.
        client.Close();
    }

Authentication

Each API call must include an authentication token.

The GetAuthenticationToken API returns a token that is valid for 24 hours and can be used for all requests within that timeframe.

GetAuthenticationToken Request Parameters

NameDescriptionType
usernameThe username for the account.
string
passwordThe password for the account.
string
applicationNameThe name of the Trimble MAPS application. (e.g. DRTrack)
string

Note: Please contact support@trimblemaps.com if you are a current DRTrack customer and you don’t know these required parameters.

Sample GetAuthenticationToken Method

public string token { get; set; }
public Authentication GetAuthenticationObj()
        {
            AuthenticationResponseEnvelope response = wc.GetAuthenticationToken("username", "password", "applicationName");
            if (response != null && response.authenticationField != null)
            {
                MyToken = response.authenticationField.authenticationTokenField;
                if (response.responseStatusField != null && response.responseStatusField.errorField != null)
                {
                    var error = response.responseStatusField.errorField.FirstOrDefault();
                    if (error != null)
                    {
                        MessageBox.Show(error.codeField + error.messageField);
                    }
                }
            }
            return new Authentication
            {
                authenticationTokenField = MyToken
            };
        }

Sample XML Request

<?xml version="1.0" encoding="utf-8"?>
<GetAuthenticationToken xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance>
  <username></username>
  <password></password>
  <applicationName><applicationName>
</GetAuthenticationToken>

Sample XML Response

<?xml version="1.0" encoding="utf-8"?>
<AuthenticationResponseEnvelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <ExtensionData />
  <authenticationField>
    <ExtensionData />
    <authenticationTokenField>DEV-Test-20170310040431-RI86TW</authenticationTokenField>
  </authenticationField>
</AuthenticationResponseEnvelope>