This article shows the steps to configure enriched 'Edge' device data (i.e. Yabby Edge Cellular) to be sent to your endpoint - via the Location Engine. Contact our support team for payload documentation.
The Edge devices 'scan' for GNSS, WiFi and Cell tower information. This raw data is sent to the Location Engine, which performs a large number of functions in order to resolve the position. This data is then forwarded to the endpoint (i.e. your server).
This results in exceptionally long battery life - and the multiple positioning methods allow for locations to be obtained when GNSS is unavailable (i.e. indoors).
1. Set up a Forwarder
A 'forwarder' determines where the Location Engine should 'forward' data to. So this is where we enter our endpoint.
- Go to the Forwarder menu in OEM Server:
Your account will need the Forwarder Manager permission. If you cannot see this menu, contact our support team to have this enabled.
- Enter forwarder details
- Name - any meaningful name
- Description - any useful description
- Type - HTTP is the only type currently
- URL - your URL
- Options in Section 1 are required, Section 2 lets you configure headers to send as part of the HTTP Post.
- You will also need to set a Distributor, Vendor, Client Group
- Once complete, you will be taken to your list of forwarders. On the right hand side of the page, click Assign Partition
Each Forwarder is a separate queue - which keeps all messages separate - to ensure if one endpoint is unavailable other devices are unaffected. There is a charge per forwarder
2. Set up a Connector
Connectors are used as they are consistent with other device types. More detail on creating connectors here: Create a Connector. For the Location Engine, we set up as follows:
- Go to the Connectors menu - your account will need the Connection Manage permission - if you can't see the menu, contact support.
- Create a new Connector:
- Provide a useful name and description
- Location Engine Connector Type
- Select the forwarder that you created previously
- Select lookup settings Default Lookups. These settings use the following services in order
- GNSS Lookups (LE-GNSS)
- Google Wi-Fi Lookups (LE-WIFI-PREMIUM)
- LE-CELL-PRO cell fallback
The above settings should work for the majority of applications. To adjust - contact DM support and we can create a new set of Lookup Settings. There are other options available at different price points per Lookup - but the accuracy varies.
- Set your DVC Group.
3. Set the Connector on your devices
See link - Set the Connector