Fleet Telematics Advanced Data Sets Developer's Guide

Map Data for a Specific Region

User Story

The user wants to retrieve road link attributes such as the route type (using a value such as motorway) and find all links inside a built-up area for all roads with functional class 3 and within a certain geographic area.

Request

The HERE Routing service provides functional road class information for each link. If the request does not specify a functional class, it needs to specify all five (5) layers (functional class 1 ... 5). For each layer, there is a level. For road link based layers, the level is always functional class + 8. To define the geographic area, specify the relevant level and tile attributes (tilex and tiley).
tileSizeDegree = 180.0 / (1 << level)
tiley = floor((latitude +  90.0) / tileSizeDegree)
tilex = floor((longitude + 180.0) / tileSizeDegree)
https://s.fleet.ls.hereapi.com/1/tile.json
?layer=LINK_ATTRIBUTE_FC3
&level=11
&tilex=2146
&tiley=1594 
&apikey={YOUR_APIKEY}
Note: This example uses 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 Advanced Data Sets, see Authentication Examples.

Response

The response to the request contains the following information blocks:
  • ISO country code
  • link ID
  • number of route types in the tile
  • if the tile is in an urban area
{
  "Rows": [
    {
      "iso_country_code": "DEU",
      "link_id": "52307959",
      "route_types": "4",
      "urban": "N"
    },
    {
      "iso_country_code": "DEU",
      "link_id": "52308006",
      "route_types": "0",
      "urban": "N"
    },
    {
      "iso_country_code": "DEU",
      "link_id": "52308070",
      "route_types": "0",
      "urban": "Y"
    },
    {
      "iso_country_code": "DEU",
      "link_id": "52308071",
      "route_types": "4",
      "urban": "N"
    },
    {
      "iso_country_code": "DEU",
      "link_id": "52308112",
      "route_types": "4",
      "urban": "Y"
    },
    {
      "iso_country_code": "DEU",
      "link_id": "52308154",
      "route_types": "4",
      "urban": "Y"
    },
    ...
  ]
}