Register the Mobile Tracker Device with MAP using a
SOAP Web Services Tool

Note: The API call described below requires authentication; your MAP username and password credentials must be used. You can easily pass these credentials in the API call within the SOAP header using the following format:

<soap:Header><username>my_username</username><password>my_password</password></soap:Header>

startTracking

Call the startTracking API from the DeviceManagementService. This sends the asset configuration you created within the createAssetConfiguration section out to the mobile tracker device and enables the features specified in this configuration.

assetId - Use the assetId returned from the createAsset request (above).

On successful return the device starts tracking and typically sending reports up to MAP.

You've completed the process of registering your mobile tracker device with MAP. If you'd like to view your asset and see its tracking information complete the steps described within the view your asset using sample applications section below. Otherwise, proceed to the What's Next? section to explore additional MAP resources.

View your asset using sample applications

You can view your asset and see tracking information using the sample apps. To do so:

1. Navigate to digi-ma.appspot.com and sign in with your user credentials. The MAP for iDigi Samples Home page will be displayed (as shown below).



2. Select the Geofences option within the toolbar; the Geofences page will be displayed. Ensure that your asset is selected from the list.
   
   
3. The Geofences page displays location information for each of your configured asset objects. A pin will be displayed on the map indicating the current location of your selected asset object.

You've completed the process of registering your mobile tracker device with MAP. Next you can proceed to the What's Next? section to explore additional MAP resources, or configure a geofence for your asset (below).

Configure a Geofence

Optionally, you can configure a geofence within the Geofences page. This geofence will be a virtual perimeter in which your asset can travel.

To configure a geofence for your asset:

1. Ensure that your asset is selected within the Assets pane of the Geofences page. For this example the "133 scooter #1" asset has been selected.
   
   
2. Click once on the map in the desired starting location for your geofence; this will establish the first point within your geofence. A blue pin will be displayed on the map.
   
   
3. Continue to select points on the map until you have outlined the desired perimeter for your geofence. This perimeter indicates the area in which your asset is allowed to travel.
   1. If you aren't satisfied with your selected perimeter, clicking the Clear Fence button will clear your perimeter and allow you to start over.
   2. Clicking the Cancel New Fence button will cancel the geofence entirely.
4. When you are satisfied with your geofence perimeter, click the Set Fence button to save your configured geofence.

You've completed the process of configuring a geofence. Proceed to the What's Next? section to explore additional MAP resources.

Back to Step 3 | Move to What's Next