Fleet Telematics Custom Locations Developer's Guide

Corridor Search for Custom Locations

User Story

The user wants to request custom locations between Friedrichstraße train station and Französische Straße metro station, both in Berlin. This is done via a corridor search.

This request is split in two parts:

First, we request a route from Friedrichstraße train station to Französische Straße metro station using the HERE Routing API. Using the response data from that request, we create an array of latitudes and longitudes.
Then, we make a request to the Fleet Telematics Custom Locations to search for all custom locations in the "HERE Stores DE" layer, using the array and a radius value to define a shape search area.

Request Summary: Routing API

HTTP method: GET

Resource: calculateroute.json

Parameters:

apiKey [apiKey={YOUR_API_KEY}]

waypoint [waypoint0=geo!52.51978,13.388211][waypoint1=geo!52.514758,13.389155], a list of waypoints that define a route. First element marks the start point, last marks the end point.

mode [mode=shortest;car], specifies the routing mode for how the route is calculated.

Request: Routing API

The code below shows an actual request matching the user story.

https://route.ls.hereapi.com
/routing/7.2/calculateroute.json
?apiKey={YOUR_API_KEY}
&waypoint0=geo!52.51978,13.388211
&waypoint1=geo!52.514758,13.389155
&mode=shortest;car

Response: Routing API

"Response": {
  "MetaInfo": {
    ...
  },
  "Route":[
    {
      "RouteId":"REM0iQIAAADG-ZtQiEJKQBnlmZf
        DxipAAAAA4IlCSkAAAABAw8YqQAAAAAAAAPB
        _AAAAAAAA8H850yIicbVOXI4HKQFdmfBL
        _RyrAAEAAACQBykBAQAAAAAdqwABAAAAAADA
        _wEAAAAAAMD_UW2D8A_K",
      "Waypoint":[
        {
          "LinkId":"+572707641",
          "MappedPosition":
          {
            "Latitude":52.5198326,
            "Longitude":13.3882084
          },
          "OriginalPosition":
          {
            "Latitude":52.519785,
            "Longitude":13.388211
          },
          "Type":"stopOver"
        },
        {
          "LinkId":"-64955564",
          "MappedPosition":
          {
            "Latitude":52.5147705,
            "Longitude":13.3891602
          },
          "OriginalPosition":
          {
            "Latitude":52.514758,
            "Longitude":13.389155
          },
          "Type":"stopOver"
        }
      ],
      "Mode":
      {
        "Type":"shortest",
        "TransportModes":[
          "car"
        ],
        ...
      },
      "Leg":[
        ...
      ],
      "Summary":
      {
        "Distance":571,
        "TrafficTime":69,
        "BaseTime":69,
        "Flags":[
        ]
      }
    }
  ]
}

Request Summary: Corridor Search

HTTP method: GET

Resource: corridor.json

Parameters:

apiKey [apiKey={YOUR_API_KEY}]

corridor [corridor=52.51978,3.388211;52.5198326,13.3882084; 52.5198402,13.3883495;52.5147705,13.3891602;52.514758,13.389155]

radius [radius=100], specifies the buffer search radius in meters.

layer_ids [layer_ids=30], specifies the list of layer IDs to be searched; only 1 layer for this example.

Request: Corridor Search

The code below shows an actual request matching the user story.

https://fleet.ls.hereapi.com/2/search/corridor.json
?apiKey={YOUR_API_KEY}
&corridor=52.51978,3.388211;
52.5198326,13.3882084;
52.5198402,13.3883495;
52.5147705,13.3891602;
52.514758,13.389155
&radius=100
&layer_ids=30

Note: These examples use a HERE API Key to authenticate your request. For information on other possible options, see Authentication Guide. For examples of how to use the other authentication options with the Fleet Telematics Custom Locations, see Authentication Examples