逆ジオコード化された位置の地図属性を取得する

地図属性サービスはさまざまなユースケースに対応するHERE Map Dataを提供します。このチュートリアルでは、単純または複数のセグメント参照の道路属性を取得する方法を示します。

座標のセグメント参照は、HERE Reverse GeocodingまたはHERE Route Matching APIを呼び出すことで取得できます。対応するAPIドキュメントを参照してください。お客様は同じ車両/アセットの複数のセグメント参照を収集するか (マルチリバース位置検知を呼び出す方法など)、複数の異なる車両/アセットの複数のセグメント参照を収集して、それらをバッチ送信して道路属性を取得できます。

複数の道路セグメントの地図属性

ルートに沿って走行している車両は、通過するセグメント (複数の場合は;で区切る) の複数のセグメント参照を返すことができます。これらのセグメント参照とレイヤーIDから、地図属性APIはHERE Map Dataを計算します。

サンプルリクエスト

curl -gX GET 'https://smap.hereapi.com/v8/maps/attributes/segments?'\
'attributes=SPEED_LIMITS_FCn(*)'\
'&segmentRefs=%241%3A87628529%230.725739..0.725739%3B%241%3A89921205%230..0.780687'\
'&apiKey={YOUR_API_KEY}'

レスポンス

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

{
  "refReplacements": {
    "0": ":1742895365354:",
    "1": "here:cm:segment"
  },
  "segments": [
    {
      "segmentRef": "$0:23600842:$1:87628529#+0.71977..1",
      "attributeDirection": "+",
      "attributes": {
        "SPEED_LIMITS_FCN": [
          {
            "FROM_REF_SPEED_LIMIT": "50",
            "TO_REF_SPEED_LIMIT": "50",
            "SPEED_LIMIT_SOURCE": "2",
            "SPEED_LIMIT_UNIT": "K"
          }
        ]
      }
    },
    {
      "segmentRef": "$0:23600842:$1:89921205#+0..0.50234",
      "attributeDirection": "+",
      "attributes": {
        "SPEED_LIMITS_FCN": [
          {
            "FROM_REF_SPEED_LIMIT": "50",
            "TO_REF_SPEED_LIMIT": "50",
            "SPEED_LIMIT_SOURCE": "2",
            "SPEED_LIMIT_UNIT": "K"
          }
        ]
      }
    },
    {
      "segmentRef": "$0:23600842:$1:89921205#+0.50235..1",
      "attributeDirection": "+",
      "attributes": {
        "SPEED_LIMITS_FCN": [
          {
            "FROM_REF_SPEED_LIMIT": "50",
            "TO_REF_SPEED_LIMIT": "50",
            "SPEED_LIMIT_SOURCE": "2",
            "SPEED_LIMIT_UNIT": "K"
          }
        ]
      }
    }
  ]
}

デモへのリンク

インタラクティブなデモはこちらのリンクからご覧いただけます：https://demo.support.here.com/examples/v3.1/map_attributes_segments

レスポンスの属性はレイヤーに関連付けられます。使用可能なレイヤーとその属性のリストを表示するには、次のURLにアクセスします。

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