Fleet Telematics Custom Locations Developer's Guide

Constructing a Request

A typical request to the Fleet Telematics Custom Locations includes the basic elements shown in the following table and, in addition, it may contain resource-specific parameters or data.

Table 1. Basic request elements
Element Value/Example Description
Base URL https://fleet.ls.hereapi.com Production environment when you use an API Key or an authentication token. For more information, see Authentication Examples.
Legacy Base URL https://cle.api.here.com Production environment when you use an app_id/app_code pair. For more information, see Authentication Examples.
Path /2/  
Resource

layers/delete

maps/delete

layers/access/grant

layers/list

layers/modify

layers/upload

search/all

search/bbox

search/corridor

search/proximity

search/quadkey

search/routeisoline

search/tile

calculaterouteisoline

 

Format

Supported formats:
  • .json
  • .txt
 
Application Code - Legacy &app_code={YOUR_APP_CODE} Substitute your own unique app_code. For more information, see Authentication Examples.
Application ID - Legacy &app_id={YOUR_APP_ID} Substitute your own unique app_id.For more information, see Authentication Examples.
API Key &apikey={YOUR_APIKEY} Substitute your own unique apikey

This example search request uses HTTP GET to request locations within 5 kilometers of a point in Berlin, Germany in layer MY_STORES:

https://fleet.ls.hereapi.com/2/search/proximity.json
?apikey={YOUR_APIKEY}
&proximity=52.50795,13.54728,5000
&layer_ids=MY_STORES
If the layer does not exist, you can create it:
https://fleet.sit.ls.hereapi.com/2/layers/upload.json
?apikey={YOUR_APIKEY}
&layer_id=MY_STORES&file=NAME%09CITY%09WKT%0d%0aBurger%20Place%09Frankfurt%09POLYGON%20((13.54728 52.50785, 13.54708 52.50795, 13.54728 52.50815, 13.54748 52.50795, 13.54728 52.50785))
Note: These examples use a HERE API Key to authenticate your request. For information on other possible options, see https://developer.here.com/documentation/authentication. For examples of how to use the other authentication options with the Fleet Telematics Custom Locations, see Authentication Examples