パスに沿って地図属性を取得する
HERE Map Attributes API v8はさまざまなユースケースに対応するHERE Map Dataを提供します。このサンプルでは、事前計算されたルートである可能性のあるパスに沿って追加の道路属性を選択する方法を示します。この機能には連続したセグメント参照のリストが必要です。
トポロジーセグメント参照
このチュートリアルでは、すべてのHERE Map Dataに基づきルートを追加情報で強化する方法を説明します。ルートは連続したセグメント参照リテラルのリストとして、またはフレキシブルなポリラインとして、提供できます。
セグメント参照については、HERE Routing APIリファレンスで説明されています(HERE Routing API v8 APIリファレンスの「spans」の「segmentRef」を参照)。そのような参照は、データを効率的に検索するために、緯度、経度、残り時間、セグメントの機能クラスも必要とします。
サンプルリクエスト
curl -gX GET 'https://smap.hereapi.com/v8/maps/attributes/path?'\
'transportMode=car'\
'&segmentRefs=$1%3A87628529%230..725739'\
'&attributes=ROAD_GEOM_FCn(*),ROAD_NAME_FCn(NAMES),LINK_ATTRIBUTE_FCn(*)'\
'&apiKey={YOUR_API_KEY}'レスポンス
サンプル応答を表示するにはクリックしてください。
{
"refReplacements": {
"0": ":1742895365354:",
"1": "here:cm:segment"
},
"segments": [
{
"segmentRef": "$0:23600842:$1:87628529#+0..0.35066",
"attributeDirection": "+",
"attributes": {
"LINK_ATTRIBUTE_FCN": [
{
"ISO_COUNTRY_CODE": "DEU",
"VEHICLE_TYPES": "1023",
"URBAN": "Y",
"TRANSPORT_VERIFIED": "Y",
"FUNCTIONAL_CLASS": "3",
"CONTROLLED_ACCESS": "N",
"LIMITED_ACCESS_ROAD": "N",
"TRAVEL_DIRECTION": "B",
"BOAT_FERRY": "N",
"RAIL_FERRY": "N",
"MULTI_DIGITIZED": "N",
"DIVIDER": "N",
"DIVIDER_LEGAL": "N",
"FRONTAGE": "N",
"PAVED": "Y",
"RAMP": "N",
"PRIVATE": "N",
"POI_ACCESS": "N",
"INTERSECTION_CATEGORY": "0",
"SPEED_CATEGORY": "6",
"LANE_CATEGORY": "1",
"COVERAGE_INDICATOR": "N0",
"TO_REF_NUM_LANES": "1",
"FROM_REF_NUM_LANES": "1",
"PHYSICAL_NUM_LANES": "3",
"LOW_MOBILITY": "3",
"PUBLIC_ACCESS": "Y",
"ROUTE_TYPES": "8"
}
],
"ROAD_GEOM_FCN": [
{
"LONG_HAUL": "N",
"NAME": "L3202 / Freigerichter Straße",
"TUNNEL": "N",
"BRIDGE": "N",
"LAT": "5020318,36",
"LON": "917879,26",
"ZLEVEL": ",",
"ELEVATION": ","
}
],
"ROAD_NAME_FCN": [
{
"NAMES": "GERBNL3202\u001e\u001eGERY\"?El %tsvaI|?Un|\"draI|sIC \"nUI \"tsvaI;GERN\"?El \"tsvaI|?Un|%draI|sIC \"nUl \"tsvaI;GERN\"lant|Stra:|s@ %draI|taU|z=nt|%tsvaI|hUn|d6t|\"tsvaI;GERN\"lant|Stra:|s@ \"tsvaI|?Un|%draI|sIC \"nUl \"tsvaI\u001dGERBNFreigerichter Straße\u001e\u001eGERY\"fraI|g@|%rIC|t6 \"Stra:|s@"
}
]
}
},
{
"segmentRef": "$0:23600842:$1:87628529#+0.35067..0.71976",
"attributeDirection": "+",
"attributes": {
"LINK_ATTRIBUTE_FCN": [
{
"ISO_COUNTRY_CODE": "DEU",
"VEHICLE_TYPES": "1023",
"URBAN": "Y",
"TRANSPORT_VERIFIED": "Y",
"FUNCTIONAL_CLASS": "3",
"CONTROLLED_ACCESS": "N",
"LIMITED_ACCESS_ROAD": "N",
"TRAVEL_DIRECTION": "B",
"BOAT_FERRY": "N",
"RAIL_FERRY": "N",
"MULTI_DIGITIZED": "N",
"DIVIDER": "2",
"DIVIDER_LEGAL": "Y",
"FRONTAGE": "N",
"PAVED": "Y",
"RAMP": "N",
"PRIVATE": "N",
"POI_ACCESS": "N",
"INTERSECTION_CATEGORY": "0",
"SPEED_CATEGORY": "6",
"LANE_CATEGORY": "1",
"COVERAGE_INDICATOR": "N0",
"TO_REF_NUM_LANES": "1",
"FROM_REF_NUM_LANES": "1",
"LOW_MOBILITY": "3",
"PUBLIC_ACCESS": "Y",
"ROUTE_TYPES": "8"
}
],
"ROAD_GEOM_FCN": [
{
"LONG_HAUL": "N",
"NAME": "L3202 / Freigerichter Straße",
"TUNNEL": "N",
"BRIDGE": "N",
"LAT": "5020354,17,21",
"LON": "917905,12,15",
"ZLEVEL": ",,",
"ELEVATION": ",,"
}
],
"ROAD_NAME_FCN": [
{
"NAMES": "GERBNL3202\u001e\u001eGERN\"lant|Stra:|s@ \"tsvaI|?Un|%draI|sIC \"nUl \"tsvaI;GERY\"?El %tsvaI|?Un|\"draI|sIC \"nUI \"tsvaI;GERN\"?El \"tsvaI|?Un|%draI|sIC \"nUl \"tsvaI;GERN\"lant|Stra:|s@ %draI|taU|z=nt|%tsvaI|hUn|d6t|\"tsvaI\u001dGERBNFreigerichter Straße\u001e\u001eGERY\"fraI|g@|%rIC|t6 \"Stra:|s@"
}
]
}
},
{
"segmentRef": "$0:23600842:$1:87628529#+0.71977..1",
"attributeDirection": "+",
"attributes": {
"LINK_ATTRIBUTE_FCN": [
{
"ISO_COUNTRY_CODE": "DEU",
"VEHICLE_TYPES": "1023",
"URBAN": "Y",
"TRANSPORT_VERIFIED": "Y",
"FUNCTIONAL_CLASS": "3",
"CONTROLLED_ACCESS": "N",
"LIMITED_ACCESS_ROAD": "N",
"TRAVEL_DIRECTION": "B",
"BOAT_FERRY": "N",
"RAIL_FERRY": "N",
"MULTI_DIGITIZED": "N",
"DIVIDER": "1",
"DIVIDER_LEGAL": "Y",
"FRONTAGE": "N",
"PAVED": "Y",
"RAMP": "N",
"PRIVATE": "N",
"POI_ACCESS": "N",
"INTERSECTION_CATEGORY": "0",
"SPEED_CATEGORY": "6",
"LANE_CATEGORY": "1",
"COVERAGE_INDICATOR": "N0",
"TO_REF_NUM_LANES": "1",
"FROM_REF_NUM_LANES": "1",
"PHYSICAL_NUM_LANES": "3",
"LOW_MOBILITY": "3",
"PUBLIC_ACCESS": "Y",
"ROUTE_TYPES": "8"
}
],
"ROAD_GEOM_FCN": [
{
"LONG_HAUL": "N",
"NAME": "L3202 / Freigerichter Straße",
"TUNNEL": "N",
"BRIDGE": "N",
"LAT": "5020392,30",
"LON": "917932,16",
"ZLEVEL": ",",
"ELEVATION": ","
}
],
"ROAD_NAME_FCN": [
{
"NAMES": "GERBNL3202\u001e\u001eGERN\"lant|Stra:|s@ \"tsvaI|?Un|%draI|sIC \"nUl \"tsvaI;GERY\"?El %tsvaI|?Un|\"draI|sIC \"nUI \"tsvaI;GERN\"?El \"tsvaI|?Un|%draI|sIC \"nUl \"tsvaI;GERN\"lant|Stra:|s@ %draI|taU|z=nt|%tsvaI|hUn|d6t|\"tsvaI\u001dGERBNFreigerichter Straße\u001e\u001eGERY\"fraI|g@|%rIC|t6 \"Stra:|s@"
}
]
}
}
]
}デモへのリンク
インタラクティブなデモはこちらのリンクからご覧いただけます：https://demo.support.here.com/examples/v3.1/map_attributes_path
HERE Map Attributes API v8の入力パラメーターの他に、このデモはHERE Routing API v8に送信されたGETリクエストまたは2セットの座標(ルートの出発地と目的地)を入力として受け入れます。次に、デモはHERE Routing APIから返されたレスポンスから関連データを抽出します。
レスポンスの属性はレイヤーに関連付けられます。使用可能なレイヤーとその属性のリストを表示するには、次のURLにアクセスします。
https://smap.hereapi.com/v8/maps/layers/list.html?&apiKey={YOUR_API_KEY}5 日前の更新