Platform Data Extension API 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://pde.cit.api.here.com/1/tiles.json
?layers=LINK_ATTRIBUTE_FC3,SPEED_LIMITS_FC4
&levels=11,12
&tilexy=2146,1594,4290,3000
&meta=1
&app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}

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 ...
 ]
}