Fleet Telematics Advanced Data Sets Developer's Guide

Map Data for Multiple Regions

User Story

The user wants to retrieve road link attributes and find all links in several areas.

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/tiles.json
?layers=LINK_ATTRIBUTE_FC3,SPEED_LIMITS_FC4
&levels=11,12
&tilexy=2146,1594,4290,3000
&meta=1
&apiKey={YOUR_API_KEY}
Note: This example uses 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 Advanced Data Sets, see Authentication Examples.

Response

The response to the request contains the following information blocks:
  • meta information for each tile
  • details for each tile and link id
{"Tiles": [
  {"Meta":
    {
      "layerName":"LINK_ATTRIBUTE_FC3",
      "tileX":"2146",
      "tileY":"1594",
      "level":"11",
      "rowCount":"2175",
      "mapRegion":"EU",
      "mapRelease":"2014Q4"
    },
   "Rows": [
    {
      "LINK_ID":"52298977",
      "ISO_COUNTRY_CODE":"DEU",
      "VEHICLE_TYPES":"1023",
      "URBAN":"Y",
      ...
     },
    ... more rows ...
   ]
  }
  ... next tile ...
 ]
}