Platform Data Extension API 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://pde.cit.api.here.com/1/tile.json
?layer=LINK_ATTRIBUTE_FC3
&level=11
&tilex=2146
&tiley=1594 
&app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}

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