ガイドAPIリファレンス
ガイド
  1. HERE Route Matching API V8
  2. 概念

HERE Route Matching API v8レスポンスのロードリンク属性

HERE Map Attributes API v8のレイヤーから取得できる制限速度や勾配などの道路リンク属性は、HERE Route Matching API v8のレスポンス内で直接取得することができます。特定のユースケースでは、このアプローチは、HERE Map Attributes API V8のタイル検索や空間検索の呼び出しよりも優れた代替手段です。&attributes=...パラメーターを使用して各レイヤーの選択された属性を取得します。

道路リンク属性を取得するタイミング

道路リンク属性はHERE Route Matching API V8の呼び出しで直接リクエストするのか、後でHERE Map Attributes API V8から取得するのか。

HERE Route Matching API V8HERE Map Attributes API V8
- HERE Route Matching API V8を呼び出す際に属性を取得する方が、クライアント側で簡単に操作できます。- HERE Map Attributes API V8のタイルデータは最大1か月間キャッシュできます。運用領域を変更しないアセットの呼び出し回数が少なくなるため、コストが削減されます。
- HERE Route Matching API v8は、ルートの一部である道路リンクに対してのみ属性データを返すため、転送されるデータ量を削減できます。- HERE Map Attributes API V8は、タイル全体のコンテンツを返すため、より多くのデータ転送が必要となります。
- 1回の呼び出しでより多くの属性をリクエストすると、HERE Route Matching API v8呼び出しのコストが増加します。
📘

注

HERE Route Matching API v8呼び出しでリクエストする属性が多いほど、コストが高くなります。

Route Matchingと互換性のあるレイヤー

HERE Route Matching API V8では、道路の特定の機能クラスの情報を含むレイヤーから地図属性をリクエストできます。

これらのレイヤーの名前はFCnで終わり、nはそのレイヤーがデータを含む機能クラスの番号です。

HERE Route Matching API V8呼び出しで使用できるレイヤーのリストを次に示します。

レイヤー名説明
ADAS_ATTRIB_FCnADAS向けにより詳細に表現された道路ジオメトリー
APPLICABLE_SPEED_LIMIT指定された車両仕様、指定された時間、そして指定されたルートに一致する経路に沿って適用される制限速度
BASIC_HEIGHT_FCnリンクの参照ノードと非参照ノードのリンク高さの値
DISTANCE_MARKERS_FCn基準位置標識として機能する、道路に沿って一定の間隔で配置された連続番号付きマーカー
EVCHARGING_POI電気自動車充電スタンド
FUELSTATION_POIガソリンスタンド
LANE_FCnリンクの車線属性
LINK_ATTRIBUTE_FCn道路リンク属性
LINK_ATTRIBUTE2_FCn道路リンク属性
LINK_TMC_FCn各リンクで、どのTraffic Message Channel (TMC) 地点に向かうかが定義されます。
LOADING_ZONE_POI商品・資材搬入口および貨物積み下ろしエリアの施設情報 (POI)
POINT_ADDRESS住所ポイント情報
POI_BIG国や視覚的な重要性に基づいて分類されたPOI
POI_BIGGER国や視覚的な重要性に基づいて分類されたPOI
POI_SMALL国や視覚的な重要性に基づいて分類されたPOI
POI_SMALLER国や視覚的な重要性に基づいて分類されたPOI
PUBLIC_TRANSPORT_POI公共交通機関の施設情報
ROAD_ADMIN_FCn道路リンクに対する行政階層の永続ID
ROAD_GEOM_FCn一般化されていない道路、フェリー、列車フェリーのジオメトリー (ポリライン)
ROAD_NAME_FCn道路名
ROAD_ROUGHNESS_FCnリンクの測定された粗さの複数表現
ROUNDABOUT_FCnロータリー
SPEED_LIMITS_FCn掲示および派生した法定制限速度
SPEED_LIMITS_COND_FCn条件付き制限速度
SPEED_LIMITS_VAR_FCn各リンクにおける進行方向と標識の設置位置を含む、可変制限速度の情報
TOLL_BOOTH_FCn料金所
TOLL_LINK_FCn道路リンクの料金情報
TOPO_SEG_ID_FCn道路のトポロジーセグメントID
TOPO_SEG_LINK_FCn道路のトポロジーセグメントのリンクID
TRAFFIC_PATTERN_FCnリンクのトラフィックパターン
TRUCK_PARKING_POIトラック駐車場POI (米国)
TRUCK_PARKING_POI_STATUSトラック駐車POIの動的コンテンツ (米国)
TRUCK_POIトラックの施設情報 (POI)
TRAFFIC_SIGN_FCn交通標識
TRUCK_SPEED_LIMITS_FCnトラック、バス、ロードトレインの制限速度
TRAFFIC_SPEED_RECORD_FCn指定された時間および指定されたルートに一致する経路に沿った、過去7日間の交通流履歴データ
TRUCK_RESTR_FCnトラックの制限
TURN_RESTR_FCnリンクに基づくルート検索の制限

レイヤー内のデータ

各レイヤーは、属性のキーと値のペアとして表される数字またはテキスト文字列の単純なレコードを持つ単一のフラットテーブルで構成されています。

道路リンク属性をリクエストするときは、取得するデータのレイヤーとデータテーブル内の列を指定する必要があります。

たとえば、以下は特定のマップタイルにおけるSPEED_LIMITS_FC1レイヤーのデータです。

| LINK_ID   | FROM_REF_SPEED_LIMIT | TO_REF_SPEED_LIMIT | SOURCE | UNIT |
| --------- | -------------------- | ------------------ | ------ | ---- |
| 566084098 | null                 | 80                 | 1      | K    |
| 566084207 | 100                  | 100                | 1      | K    |
| 566089718 | null                 | 100                | 1      | K    |
| 578304140 | null                 | 100                | 1      | K    |
| 578313250 | 100                  | null               | 1      | K    |
  • このレイヤーからすべてのデータを取得するには、APIコールで&attributes=SPEED_LIMITS_FC1(*)を使用します。
  • FROM_REF_SPEED_LIMIT列およびTO_REF_SPEED_LIMIT列からデータを取得するには、APIコールで&attributes=SPEED_LIMITS_FC1(FROM_REF_SPEED_LIMIT,TO_REF_SPEED_LIMIT)を使用します。
  • すべてのSPEED_LIMITSレイヤーからすべてのデータを取得するには、APIコールで&attributes=SPEED_LIMITS_FCn(*)を使用します。

使用可能なすべての属性レイヤーとそのレイヤーに含まれるデータのリストを取得するには、/v8/maps/layers/list.htmlリソースを使用します。プレースホルダーをAPIキーに置き換えて、次のURLにアクセスします。

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

注

レイヤー内の列の順序を変更したり、新しい列を追加したりできます。アプリケーションでこの点を考慮するようにしてください。

データ量の最適化

転送されるデータ量を減らすために、レイヤー内の多くの列は非正規化またはエンコードされます。

特定のレイヤーの詳細を取得するには、次のURLにアクセスして、プレースホルダーをレイヤー名とAPIキーに置き換えます。

https://smap.hereapi.com/v8/maps/layers/doc.html?layer=LAYER_NAME&apiKey=YOUR_API_KEY

20 日前の更新