ガイドAPIリファレンス
ガイド
  1. HERE Traffic Vector Tile開発者ガイド

HERE Traffic Vector Tile APIのデータレイヤー

HERE Traffic Vector Tile APIのデータは、Mapzenによって開始されたTilezenオープンソースプロジェクトで指定された定義に従って、レイヤーで整理されます。

以下のセクションでは、トラフィックレイヤーの構造に関する情報を提供します。

HERE Traffic Vector Tile APIでは、元のレイヤー定義と同じ構造を使用して変更内容を見つけやすくし、Tilezenが作成したものと同じ「セマンティックバージョニングのステートメント」に従います。

データソースと帰属

HERE Traffic Vector Tile APIは、HEREのデータを使用します。 詳細については、「必須の著作権表示」を参照してください。

タイルでのソースプロパティの使用

通常、sourceプロパティはすべてのタイルで省略されます。別途記載がない限り、値はhere.comであると想定してください。 しかし、世界の一部の地域についてはcoreレイヤーパラメーター内にこのプロパティが存在しており、プロパティ値はデータソースプロバイダーを示します。たとえば、日本の値はipcです。

用語の定義

  • common - 通常、これらのレイヤー、プロパティ、種類はレスポンスのすべてのフィーチャーで使用できます。
    • フィーチャーの基本的な選択と、特定の名前の付いたレイヤーへのフィーチャーの配置を設定します。
    • フィーチャーの表示とラベル付けに必要なコアプロパティ。
      • トラフィックベクタータイルのコンテンツを相互運用可能にする特殊ビット (kind、kind_detail、landuse_kind、min_zoom、sort_rankなど)。
      • name(ローカライズされた名前を含む)など、ほぼすべてのフィーチャーに含まれる基本的なプロパティ。
  • common-optional - これらはcommonのセットの一部ですが、関連性がない、またはデータがないために存在しない可能性があります (主にフィーチャーのプロパティであるが、レイヤーにもなり得る)。
    • フィーチャーの選択を絞り込むために使用します。
    • 元のデータ値に基づいて、わずかに変更を加えた相互運用可能なプロパティ。
    • sort_rank などの基本的なプロパティ。
  • optional - 特定のそれほど重要ではない kind のプロパティであるか、例外的に複数の kind にわたり広く存在します。
    • すでに表示用に選択されているフィーチャーを「装飾」するためによく使用されます。

フィーチャー名

トラフィックベクタータイルのほとんどのフィーチャーには、nameのプロパティがcommonプロパティのリストに含まれています。例は次のとおりです。

  • name - 通常、フィーチャーの現地での呼び名です。現地言語で表記されます。

ジオメトリータイプ

トラフィックタイルジオメトリーは次の2タイプのいずれかになります。

  • point - ポイント、マルチポイント
  • line - ラインストリング、マルチラインストリング

データの更新

トラフィックデータは動的な性質を持つため、トラフィックタイルは約1分で更新されます。

ChangeLog

HERE Traffic Vector Tile APIレイヤー定義の現在のバージョンは*v1.0.0.*です。

データモデルの仕様は「セマンティックバージョニングのステートメント」に掲載されています。

詳細については、「変更」セクションを参照してください。

フィーチャーの順序

フィーチャーの順序は、どのフィーチャーを他のフィーチャーの上に表示するかを決定しますが、この順序が地図のレンダリング時に重要な問題になることがあります。一部のフィーチャーにはsort_rankプロパティがあります。これは表示されるフィーチャーの順序を示すもので、地図のレンダリングに活用されます。数値が小さいほどフィーチャーが「後方」に表示され、数値が大きいほど「前方」に表示されます。これらの数値は、トラフィックレイヤー間で一貫しています。

道路のプロパティ (common-optional)

次の共通プロパティでは、トラフィックタイルフィーチャーの道路に関する追加情報を定義します。

道路交通機関のkind値

  • aerialway
  • ferry
  • hgv_restriction
  • highway
  • major_road
  • minor_road
  • path
  • rail
  • piste

道路交通機関のkinddetail値

  • ferry - ferry種類用
  • motorway - highway種類用
  • trunk - highway種類用
  • primary - major_road種類用
  • secondary - major_road種類用
  • tertiary - major_road種類用
  • residential - minor_road種類用
  • service - minor_road種類用
  • unclassified - minor_road種類用
  • pedestrian - path種類用
  • footway - path種類用
  • rail - rail種類用
  • chair_lift - aerialway種類用
  • downhill - piste種類用

トラフィックレイヤー

HERE Traffic Vector Tile APIには、次のレイヤーが含まれます。

  • traffic_flow
  • traffic_incidents
  • incident_icons

トラフィックデータは非常に動的な性質を持つため、これらのレイヤーは約1分ごとに更新されます。 次の図は、すべてのトラフィックレイヤー (traffic_flow、traffic_incidents、incident_icons) をレンダリングした例を示しています。 交通情報 交通情報

交通流

次の図は、データからレンダリングされた交通流の例を示しています。 交通流 交通流

レイヤーのコンテンツは次のように定義されます。

  • レイヤー名：traffic_flow
  • ジオメトリータイプ：line

交通流のプロパティ (common)

  • id - 一意のトラフィックイベントID。特定のイベントの交通情報の更新を確認できます。
  • kind - トラフィックプロバイダーが認識するフロー情報の重大度に基づきトラフィックを「色」で示します。使用可能な値については、以下を参照してください。
  • min_zoom - フィーチャーの描画時に使用するズーム率を浮動小数値で提案します。値は、以下に説明するroad_kind、kind、kind_detailの値の組み合わせから取得されます。

交通流のkind値

  • unknown - 交通状況が不明
  • free - 自由に走行できる、邪魔されない交通
  • minor - わずかに交通渋滞あり
  • slow - 交通速度が遅くなっている
  • queuing -渋滞しているが、まだゆっくりと動いている
  • stationary - 交通が止まっている、渋滞
  • none - 障害物や閉鎖により交通がない

交通流のプロパティ (common-optional)

  • source - 交通情報のプロバイダー。
  • congestion - 交通流のレベル。0.0は完全に自由に走行できる交通状況、1.0は完全に渋滞している交通状況。
  • speed - 速度 (km/時)。
  • drives_on_left - その国で左車線を走行する場合はtrueに設定 (英国など)。
  • sort_rank - このプロパティには、フローフィーチャーをレンダリングする順序を指定します。この値は整数です。小さい数値のフィーチャーは、より大きな数値のフィーチャーの「背後」に配置されます。

交通流のプロパティ (optional)

  • road_kind - 道路プロパティ (common-optional) の道路交通機関のkind値を参照してください。
  • road_kind_detail - 道路プロパティ (common-optional) の道路交通機関のkinddetail値を参照してください。
  • is_bridge - 直線が橋の場合はtrueに設定します。
  • is_tunnel - 直線がトンネルの場合はtrueに設定します。
  • is_link - 直線が高速道路への進入路の場合はtrueに設定します。
  • is_hov_lane - 直線がHOV (乗車定員の多い車両) 優先車線の場合はtrueに設定します。

交通事案

次の図は、データからレンダリングされた交通事案の例を示しています。 交通事案 交通事案

レイヤーのコンテンツは次のように定義されます。

  • レイヤー名：traffic_incidents
  • ジオメトリータイプ：line

交通事案のプロパティ (common)

  • id - 一意のトラフィックイベントID。指定されたイベントの交通情報の更新を確認できます。
  • kind - インシデントのタイプ。使用可能な値については、以下を参照してください。
  • min_zoom - フィーチャーの描画時に使用するズーム率を浮動小数値で提案します。この値は、次に説明するwarning_level値から取得されます。

交通事案のkind値

  • accident - 事故が発生している。
  • congestion - 渋滞が発生している。
  • construction - 建設または道路工事が行われている。
  • disabled_vehicle - 車両が動けず、通行を妨げている。
  • lane_restriction - 車線が閉鎖されている。
  • mass_transit - 多数の人々が、ある場所から別の場所に移動している。
  • planned_event - 計画的なイベントが開催され、混乱が発生している。
  • road_closure - 交通事案、道路工事、公共イベントにより道路が閉鎖されている。
  • road_hazard - 道路に危険物がある。
  • weather - 気象条件が混乱を引き起こしている。
  • other - 上述のラベルで説明できないインシデントが発生している。

交通事案のプロパティ (common-optional)

  • source - 交通情報のプロバイダー。
  • sort_rank - このプロパティに、フローフィーチャーをレンダリングする順序を指定します (交通事案ラインジオメトリーのみ)。この値は整数です。小さい数値のフィーチャーは、より大きな数値のフィーチャーの「背後」に配置されます。
  • start_time - インシデントが開始する/開始した時刻 (UNIX時間)。少なくとも1つのstart_timeまたはstop_timeを設定する必要があります。
  • stop_time - インシデントが終了する/終了した時刻 (UNIX時間)。少なくとも1つのstart_timeまたはstop_timeを設定する必要があります。

交通事案のプロパティ (optional)

  • warning_level - 発生したインシデントの重大度。次の値を指定できます。low (最も重大度が低い)、minor、major、critical (最も重大度が高い)。
  • road_kind - 道路プロパティ (common-optional) の道路交通機関のkind値を参照してください。
  • road_kind_detail - 道路プロパティ (common-optional) の道路交通機関のkinddetail値を参照してください。
  • is_bridge - 直線が橋の場合はtrueに設定します。
  • is_tunnel - 直線がトンネルの場合はtrueに設定します。
  • is_link - 直線が高速道路への進入路の場合はtrueに設定します。
  • drives_on_left - その国で左車線を走行する場合はtrueに設定 (英国など)。
  • is_hov_lane - 直線が、またはインシデントがHOV (乗車定員の多い車両) 優先車線に影響を与える場合はtrueに設定します。

インシデントアイコン

次の図は、データからレンダリングされた交通事案アイコンの例を示しています。 交通事案アイコン 交通事案アイコン

  • レイヤー名：incident_icons。
  • ジオメトリータイプ：point。

このレイヤーでは、インシデントのアイコンに関する情報を定義します。traffic_incidentsレイヤーと同じ構造を使用します。トラフィックインシデントレイヤーのすべてのプロパティはincident_iconsレイヤーにも存在します。

インシデントアイコンは、インシデントのprimaryまたはsecondaryの場所に提供されます。場所Primaryとは、インシデントの原因 (事故や渋滞など) が発生した場所で、インシデントの影響を受けた道路部分の端に位置します。Secondaryの場所は、インシデントの影響を受けた道路部分の始まりです。

インシデントアイコンのプロパティ (optional)

  • is_primary：true-フィーチャーがインシデントのプライマリ位置のアイコン配置を表す場合、false (またはオプションがない) - フィーチャーがインシデントのセカンダリ位置のアイコン配置を表す場合。
  • offset_direction：交通障害の進行方向に対して垂直な方向と真北の間の角度 (度単位)。北から時計回りに回転して、0～359の範囲の整数で表されます。

18 日前の更新