Polte’s Cloud Location Services Quick Start Guide

Track the location of your device with a seamless integration from your device to the Polte Cloud.

1. Claim the Device

1A. Request an Account

  • You should have a polte.io and track.polte.io accounts. (You can request an account here).
  • Login to https://polte.io/login.

1B. Initiate Bulk Claim

  • Next, to claim your device IMEI (UE): Click on User Equipments Menu→Bulk claim.
  • Enter imei (s) in a CSV file and upload.
  • Click on the Submit button.
  • You can track the device location at track.polte.io.

1C. Directions for Third Party Integrator

If you are a third party integrator with Polte, read on…​

To consume Polte APIs, you have to authenticate with login credentials and the Polte Server issues a Bearer token that you use for authorization when you make REST API calls.

  • Go to Customer endpoint URL- https://polte.io/swagger/customer/
  • Call the Login API as shown below with the same polte.io credentials.
POST /users/login

curl -X POST https://polte.io/api/v1/users/login
-H "accept: application/json"
-H "Content-Type: application/json"
-d "{ \"email\": \”abc@polte.com\", \"password\": \”xxxxxxxx\"}”

Authorization: Bearer <Access-token>
  • You can claim your device as mentioned in the steps above OR you can claim your device with the REST API call.
POST /customer/{customerId}/userEquipment/claim

curl -X POST https://polte.io/api/v1/customer//userEquipment/claim \
-H "accept: application/json" \
-H "Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d "{ \"imeis\": [ \"\" ]}"

2. Register the Device

2A. Create API Token

  • To register your device, the MCU triggers the AT+POLTEREG? command to the Chipset.
  • The Chipset sends back the Registration tokens which are in turn sent to the integrator’s cloud.
  • To register device using Polte API, you have to create API token.
  • Go to https://polte.io/swagger/customer/
  • Call the API to create an API token.
POST /customer/{customerId}/apiTokens

curl -X POST https://polte.io/api/v1/customer//apiTokens \
-H "accept: application/json" \
-H "Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d "{ \"role\": \"UE\"}”

2B. Copy the API Token

  • Copy the API token from the API response.
  • Return to UE endpoint URL, https://polte.io/swagger/user-equipment/ and enter the API-Token in the format shown.
 IMPORTANT: The token format is Polte-API <API-token>.
  • You are authorized to call UE APIs.
  • You can now register the device.
  • Go to https://polte.io/swagger/user-equipment/
Call the register API, GET /ue/register/

curl -X GET https://polte.io/api/v1/ue/register?manufacturerToken=&modelToken=&ueToken=&imei= \
-H "accept: application/json" \

-H "Authorization: Polte-API API-Token"
  • Polte Cloud will return the MQTT tokens (mqttAuthUser:mqttAuthPassword) which are needed for interacting with the
 locate APIs.

3. Locate the Device

3A. Create X-UE-Auth String

  • To get the location of the device, payload data is sent over AT+POLTECOMPRESS command.
  • Create X-UE-Auth string which is base64 encoding of mqtt tokens (mqttAuthUser:mqttAuthPassword).

3B. Request Location

  • Request API call to return the location (lat/long).
POST /ue/{ueToken}/locate

curl -X POST https://polte.io/api/v1/ue/>/locate?sync=true \

-H "accept: application/json" \
-H "X-UE-Auth: base64 encoded mqttAuthUser:mqttAuthPassword" \
-H "Authorization: Polte-API API-Token" \
-H "Content-Type: application/json" \
-d "{ \"payload\": \”payload from device\"}"

 

Polte provides you with Swagger, an interactive tool to try out Polte’s Location Service APIs.

Polte’s breakthrough location technologies, coupled with Fleetilla’s nearly two decades expertise in design and deployment of long-life, wide area outdoor location solutions, will allow us to now offer seamless end-to-end supply chain and equipment visibility – indoors and outdoors.

Visit our documentation page to gain access to Polte APIs.