CloudLocate Service-to-Service access using REST API

Introduction

Service-to-Service access enables you to leverage the power of CloudLocate sending the GNSS measurements from your application platform, instead of directly using your IoT device.

This documentation will guide you through the process of setting up your Thingstream account for service-to-service access using the REST API

As an alternative option, you can publish the data using an MQTT client as described in this guide.

Prerequisites

The prerequisites to complete the procedure are:

  1. you have access to the u-blox Thingstream portal and you have already created a domain

  2. you have registered a credit card in the portal or you have a credit line active.

  3. you have knowledge and tools about how to send an API request

Procedure overview

The mains steps of this procedure are

  1. Create a CloudLocate S2S Thing, just one for all your fleet.

  2. Select the preferred pricing plan

  3. Get the credentials for REST API access

  4. Send the measurements using the API and get the location back


Create a CloudLocate S2S Thing

The first step is to create a CloudLocate S2S things that provides you all the parameters to send the API:

  • username and password

  • service endpoint

The Thing let also you to:

  • modify the pricing plan

  • deactivate/ reactivate the access

  • monitor the usage of the service

  • and look at the the events

Sign-in into the Thingstream portal and select the Location Things item from the Location Services section. Click the button to create a new Location Thing and browse to the CloudLocate section from where you can select the wizard to create CloudLocate S2S Thing.

During the creation steps you are suggested to assign a price plan. If you skip this step the Thing will not be automatically activated and cannot be used. When you are ready to assign a plan, open the Thing panel and assign the preferred one.

Get the position estimation

To obtain the position estimation, send the raw measurement generated by the GNSS in the device to CloudLocate service endpoint using a REST API.

Note: the endpoint is specified in the details panel of the just created CloudLocate S2S thing

API specifications are available at https://clapi.services.u-blox.com/.

You can send the raw measurement in one of the two allowed format:

  1. as a binary payload. Additional information about binary format are available at this page

  2. as a base64 encoded hex string;

As explained in the API documentation, in case of delayed message, date and time shall be added in the header of the request.