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>

createAssetConfiguration

Call the createAssetConfiguration API from the DeviceManagementService. This is where you will enable any of the tracking features of the mobile tracker device being used, such as location tracking, geofencing, start and stop alerts, etc. In this step, the configuration is created and stored in MAP associated with the asset object. It will be sent down to the tracker device as part of the startTracking request in the next step. Input parameters are:

assetID - Use the assetId returned from the createAsset request.

featureVOs - Each tracking feature of the tracker device is represented by a feature VO object. Within the feature object may be any number of attributeVOs defining the specific characteristics of that feature. Typically, a feature includes a feature name attribute plus a Boolean identifying whether the feature is enabled or not. For example:

            <xsd:featureVOs>
               <xsd:featureName>Location Tracking</xsd:featureName>
               <xsd:attributeVOs>
                  <xsd:attrName>Location Tracking Feature</xsd:attrName>
                  <xsd:attrValue>true</xsd:attrValue>
               </xsd:attributeVOs>
               <xsd:attributeVOs>
                  <xsd:attrName>Continuous Tracking</xsd:attrName>
                  <xsd:attrValue>true</xsd:attrValue>
               </xsd:attributeVOs>
               <xsd:attributeVOs>
                  <xsd:attrName>Tracking Interval</xsd:attrName>
                  <xsd:attrValue>15</xsd:attrValue>
               </xsd:attributeVOs>
               <xsd:attributeVOs>
                  <xsd:attrName>Packet Size</xsd:attrName>
                  <xsd:attrValue>1</xsd:attrValue>
               </xsd:attributeVOs>
            </xsd:featureVOs>

Note: You can use getDeviceTypeConfiguration for a complete list of features supported by the tracker device you're using.

You've completed the createAssetConfiguration process. Proceed to the startTracking section where you will send the asset configuration you just created out to the mobile tracker device and enable the features specified in this configuration.

Back to Step 3 | Move to startTracking