ガイドAPIリファレンス
ガイド

地図表示のためにHERE Map Contentを取得する

HERE Routing APIV8を使用して計算されたルートのHERE Map Contentを取得するには、HERE Map Attributes APIV8を使用します。次は取得方法の例です。

  • 道路勾配データ
  • 最大車両高さデータ
  • 交通標識
📘

次の例はレイヤーとその属性を示しています。使用可能なレイヤーとその属性の完全なリストを取得するには、次のURLを参照してください。

https://smap.hereapi.com/v8/maps/layers/list.html?&apiKey={YOUR_API_KEY}

道路勾配

ADAS_ATTRIB_FCnレイヤーには、道路勾配値などのADASデータが含まれています。計算されたルートが通過するタイルに対して、HERE Map Attributes API V8を呼び出すと、これらのレイヤーを取得できます。また、ルート内のセグメントをフィルタリングすると、ルート上の各シェイプポイントにおける勾配を見つけることができます。

このユースケースのWebデモを見るには、こちらのリンクをクリックしてください。

サンプルリクエスト

curl -gX GET 'https://smap.hereapi.com/v8/maps/attributes?'\
'layers=ADAS_ATTRIB_FC4,ADAS_ATTRIB_FC2,ADAS_ATTRIB_FC4,ADAS_ATTRIB_FC4,ADAS_ATTRIB_FC4,ADAS_ATTRIB_FC4'\
'&in=tile:24267002,1516094,24275195,24275196,24283388,24283387'\
'&apiKey={YOUR_API_KEY}'

レスポンス

サンプル応答を表示するにはクリックしてください。

このレスポンス例は途中で省略されています。

{
"Tiles":[
  {
    "Meta":{
      "layerName":"ADAS_ATTRIB_FC4",
      "tileId":24267002,
      "level":12,
      "mapRegion":"NA",
      "mapRelease":"22132"
    },
    "Rows":[
      {
        "LINK_ID":"23439120",
        "HPX":"-789744500,1656,1741,7203,8062,5238,2553,9947",
        "HPY":"402055300,1390,1462,6048,6668,4332,1899,7401",
        "HPZ":"51393,73,100,444,502,246,63,203",
        "SLOPES":"1574,786,418,33,-33,-1350,-384,-177",
        "HEADINGS":"41422,870,619,-236,1714,944",
        "CURVATURES":"-802,223,920,-601,-391,212",
        "VERTICAL_FLAGS":"1,1,0,1,0,1",
        "REFNODE_LINKCURVHEADS":"1:6813:58198,3:-1015:40329",
        "NREFNODE_LINKCURVHEADS":"1101743704:280:45365",
        "BUA_ROAD":"0",
        "BUA_ROAD_VERIFIED":null,
        "LINK_ACCURACY":"3",
        "TOPOLOGY_ID":"398861176",
        "START_OFFSET":"0",
        "END_OFFSET":"1"
      },

      ...

高さ

BASIC_HEIGHT_FCnレイヤーには、タイル状に分割された高さデータが含まれています。計算されたルートが通過するタイルに対して、HERE Map Attributes API V8を呼び出すと、これらのレイヤーを取得できます。また、ルート内のセグメントをフィルタリングすると、ルートに沿った対応する高さ値を見つけることができます。

このユースケースのWebデモを見るには、こちらのリンクをクリックしてください。

サンプルリクエスト

curl -gX GET 'https://smap.hereapi.com/v8/maps/attributes?'\
'layers=BASIC_HEIGHT_FC4,BASIC_HEIGHT_FC2,BASIC_HEIGHT_FC4,BASIC_HEIGHT_FC4,BASIC_HEIGHT_FC4,BASIC_HEIGHT_FC4'\
'&in=tile:24267002,1516094,24275195,24275196,24283388,24283387'\
'&apiKey={YOUR_API_KEY}'

サンプルレスポンス

サンプル応答を表示するにはクリックしてください。

このレスポンス例は途中で省略されています。

{
"Tiles":[
  {
    "Meta":{
      "layerName":"BASIC_HEIGHT_FC4",
      "tileId":24267002,
      "level":12,
      "mapRegion":"NA",
      "mapRelease":"22132"
    },
    "Rows":[
      {
        "LINK_ID":"23439120",
        "DTM_MIN_HEIGHT":"51393",
        "DTM_MAX_HEIGHT":"53024",
        "DTM_AVG_HEIGHT":"52194",
        "DTM_REF_ZCOORD":"51393",
        "DTM_NONREF_ZCOORD":"53024",
        "TOPOLOGY_ID":"398861176",
        "START_OFFSET":"0",
        "END_OFFSET":"1"
      },

      ...

交通標識

TRAFFIC_SIGN_FCnレイヤーには、タイル状に分割された交通標識データが含まれています。計算されたルートが通過するタイルに対して、HERE Map Attributes API V8を呼び出すと、これらのレイヤーを取得できます。また、ルート内のセグメントをフィルタリングすると、ルートに沿って現れる交通標識を見つけることができます。

このユースケースのWebデモを見るには、こちらのリンクをクリックしてください。

サンプルリクエスト

curl -gX GET 'https://smap.hereapi.com/v8/maps/attributes?'\
'layers=TRAFFIC_SIGN_FC4,TRAFFIC_SIGN_FC2,TRAFFIC_SIGN_FC2,TRAFFIC_SIGN_FC2,TRAFFIC_SIGN_FC4'\
'&in=tile:25833791,1614927,1614928,1614929,25825605'\
'&apiKey={YOUR_API_KEY}'

サンプルレスポンス

サンプル応答を表示するにはクリックしてください。

このレスポンス例は途中で省略されています。

{
  "Tiles":[
    {
      "Meta":{
        "layerName":"TRAFFIC_SIGN_FC4",
        "tileId":25833791,
        "level":12,
        "mapRegion":"WEU",
        "mapRelease":"22136"
      },
      "Rows":[
        {
          "CONDITION_ID":"724552153",
          "CONDITION_TYPE":"17",
          "LINK_IDS":"-567673157",
          "VEHICLE_TYPES":"1023",
          "TRAFFIC_SIGN_TYPE":"42",
          "TRAFFIC_SIGN_VALUE":null,
          "GEN_WARNING_SIGN_TYPE":null,
          "TRAFFIC_SIGN_CATEGORY":"1",
          "TRAFFIC_SIGN_SUBCATEGORY":"1",
          "SIGN_DURATION":null,
          "SIGN_PREWARNING":null,
          "SIGN_VALIDITY_TIME":null,
          "SIGN_VEHICLES":"0",
          "SIGNAL_SIGN_LOCATION":null,
          "RAILWAY_CROSSING_TYPE":null,
          "WEATHER_TYPE":null,
          "IMPORTANCE_IND":null,
          "SIGN_TEXT":null,
          "DATE_TIMES":null,
          "TOPOLOGY_IDS":"78180131",
          "START_OFFSETS":"0",
          "END_OFFSETS":"1"
        }
      ]
    },
  ...

道路リンク属性

LINK_ATTRIBUTE_FCnレイヤーには道路リンク属性が含まれています。計算されたルートが通過するタイルに対してHERE Map Attributes API v8を呼び出し、表示されるルートに沿ったセグメントのみのコンテンツをフィルタリングします。

サンプルリクエスト

curl -gX GET 'https://smap.hereapi.com/v8/maps/attributes?'\
'layers=LINK_ATTRIBUTE_FC1,LINK_ATTRIBUTE_FC2,LINK_ATTRIBUTE_FC3,LINK_ATTRIBUTE_FC4,LINK_ATTRIBUTE_FC5'\
'&in=tile:401926,1608716,6432793,25727025,102916195'\
'&apiKey={YOUR_API_KEY}'

サンプルレスポンス

サンプル応答を表示するにはクリックしてください。

このレスポンス例は途中で省略されています。

{
  "Tiles":[
    {
      "Meta":{
        "layerName":"LINK_ATTRIBUTE_FC1",
        "tileId":401926,
        "level":9,
        "mapRegion":"WEU",
        "mapRelease":"22136"
      },
      "Rows":[
        {
          "LINK_ID":"709291533",
          "ISO_COUNTRY_CODE":"FRA",
          "VEHICLE_TYPES":"1007",
          "URBAN":"N",
          "TRANSPORT_VERIFIED":"Y",
          "FUNCTIONAL_CLASS":"1",
          "CONTROLLED_ACCESS":"Y",
          "LIMITED_ACCESS_ROAD":"Y",
          "TRAVEL_DIRECTION":"T",
          "BOAT_FERRY":"N",
          "RAIL_FERRY":"N",
          "MULTI_DIGITIZED":"Y",
          "DIVIDER":"N",
          "DIVIDER_LEGAL":"N",
          "FRONTAGE":"N",
          "PAVED":"Y",
          "RAMP":"N",
          "PRIVATE":"N",
          "POI_ACCESS":"N",
          "INTERSECTION_CATEGORY":null,
          "SPEED_CATEGORY":"2",
          "LANE_CATEGORY":"2",
          "COVERAGE_INDICATOR":"N0",
          "TO_REF_NUM_LANES":"2",
          "FROM_REF_NUM_LANES":null,
          "PHYSICAL_NUM_LANES":null,
          "LOW_MOBILITY":"3",
          "PUBLIC_ACCESS":"Y",
          "GRADE_CATEGORY":null,
          "ROUTE_TYPES":"3",
          "OVERPASS_UNDERPASS":null,
          "TOPOLOGY_ID":"843266494",
          "START_OFFSET":"062892",
          "END_OFFSET":"085238"
        },
    ...

例へのリンクリソース
さまざまなリンク属性/v8/maps/attributes
道路名とジオメトリー/v8/maps/attributes