レイヤーの概要

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

以下のセクションには、トラフィックレイヤーの構造を理解するために必要なすべての情報が含まれています。

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

概要

データソースとアトリビューション

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

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

このプロパティ source は、通常、すべてのタイルで省略されます。 特に記述がない限り、値はhere.comであると想定してください。

ただし core layer パラメーター内のワールドの一部のリージョン( 日本など ) では、このプロパティが存在し、プロパティ値がデータソースプロバイダを示します。 日本の場合、値は ipcです。

用語の定義

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

フィーチャー名

トラフィックベクタータイル のほとんどの機能には、 次のようなプロパティcommonのリストに基本的なプロパティnameが含まれています。

• name - 一般に、ローカルでこのフィーチャーを呼び出す名前で、ローカル言語のスクリプトが使用されます。

ジオメトリータイプ

Traffic タイル のジオメトリには、次の 2 つのタイプがあります。

• point - Point、Multipoint
• line - LineString 、 MULTILINESTRING

データの更新

トラフィックデータは非常に動的な性質を持っているため、トラフィックタイルは 1 分ごとに更新する必要があります。

更新履歴

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

データモデルプロミスは、 セマンティックバージョニングステートメントに一覧表示されます。

「変更」セクションの詳細情報を参照してください。

機能の順序付け

他のフィーチャーの上にどのフィーチャーをレンダリングするかを決定する機能の順序付けは、マップのレンダリング時に重要な問題になります。 マップのレンダリングを支援するために、一部のフィーチャーには、表示されるフィーチャーの順序を示すプロパティ sort_rank があります。 数値が小さいほど、フィーチャーは「後方」に向かって表示され、数値が大きいほど「前方」に向かって表示されます。 これらの数は、トラフィックレイヤー全体で一貫しています。

道路状況 (common-optional)

次の共通プロパティを使用して、 Traffic タイル フィーチャーの道路に関する追加情報を定義します。

道路輸送方法kind の値

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

道路輸送方法kinddetail の値

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

トラフィックレイヤー

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 - 上記の道路の値kindを参照してください。
• road_kind_detail - 上記の道路の値kind_detailを参照してください。
• 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 を設定する必要があります。
• title - 英語用 title:en や ドイツ語用title:deなどのローカライズされた、インシデントの簡単な説明。 画面に表示されるポップアップのタイトルに使用できます。
• description - インシデントの説明とコメントが長くなる可能性があります。 上記 title のようにローカライズされています。

交通障害のプロパティ (optional)

• warning_level - 発生したインシデントの重大度。次の値を指定できます。 low ( 最も重大度が低い ) 、 minor、 majorおよび critical ( 最も重大度が高い ) 。
• road_kind - 上記の道路の値kindを参照してください。
• road_kind_detail - 上記の道路の値kind_detailを参照してください。
• 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に設定され、フィーチャがインシデントの第 2 の場所のアイコン位置を表す場合は false (またはオプションが存在しない) に設定されます。
• offset_direction: 真の北と、障害の方向に垂直な駆動側の間の角度 ( 度単位 ) 。 北から時計回りに回転して、 0 ～ 359 の範囲の整数で表されます。