ガイドAPIリファレンス
ガイド
  1. ベクタータイルAPI開発ガイド
  2. HERE Vector Tile APIの概念
  3. 任意のコンテンツ - HERE Vector Tile API

公共交通機関、V2

transitレイヤーは、バス、列車、地下鉄、その他の方式の公共交通機関など、公共交通機関システムに関する情報を提供します。このレイヤーのフィーチャーを使用して開発者が公共交通機関データをアプリケーションやサービスに統合すると、ユーザーがルートの計画、スケジュールの参照、公共交通機関オプションに関するリアルタイム情報の取得を行えるようになります。

クエリにcontent=default,transitパラメーターを追加することで、公共交通機関レイヤーをリクエストできます。詳細については、「任意のコンテンツ」を参照してください。

📘

注

contentパラメーターの属性の順序は重要です。特に、default属性は最初に指定するようにしてください。

次の図は、データからレンダリングされたtransitレイヤーのフィーチャーのサンプルを示しています。

東京の運送レイヤー フィーチャーのサンプル レイヤーのコンテンツの定義は次のとおりです。

  • レイヤー名：transit
  • ジオメトリー タイプ：polygon、line

トランジット ライン フィーチャーはズーム レベル 6 以上で表示され、ズーム レベル 14 以上で platform ポリゴンが追加されます。

効率を最適化するため、2 つのレベルのフィーチャー統合 (LOC) を用意しています。

  • LOC 1：kind と kind_detail の値のペアごとに 1 つのライン ジオメトリー フィーチャーがあります。このセグメントの kind と kind_detail のすべてのライン名が 1 つの文字列に連結されて含まれます。この LOD を使用すると、詳細度の低いネットワーク (kind_detail ごとに 1 つのライン) を表示したり、この kind_detail の連結ラベルをすべて表示したりできます。これらの連結ラベルは、LOC2 ラインの行として適切にフォーマットされたラベルをすべて表示するために使用することもできます。
  • LOC 2：同じ kind、kind_detail、colour を持つ公共交通機関ライン セグメント毎に、ライン ジオメトリー フィーチャーが 1 つ追加されています。同じセグメントに同じオペレーターが色/typeを指定している複数の公共交通機関ラインがある場合、それらのジオメトリーは 1 つのラインに結合され、すべてのライン名がリストとして追加されます。クライアントは、論理オフセットとスタイルで定義されたピクセルオフセットを乗算することで、単純な平行線をレンダリングできます。

プロパティ

transit レイヤーのすべてのフィーチャーには、そのフィーチャーが表す特定の運送タイプに関わらず、そのフィーチャーを定義する一連のプロパティが含まれています。

一般的なトランジット ルート セグメント ライン ジオメトリーを表すトランジット フィーチャーの次のサンプル パラメーターを検討してください。

Tohoku Line 都市間路線は #00BB85 の色で表され、Takasaki Line と Utsunomiya Line 都市間路線は #FF871C の色で表されます。

LOC 1：

...
"kind": "train",
"kind_detail": "intercity",
"min_zoom": 8,
"sort_rank": 436,
"name": "宇都宮線  ·  東北本線  ·  高崎線",
"name:en": "Takasaki Line  ·  Tohoku Line  ·  Utsunomiya Line",
"name:ja": "宇都宮線  ·  東北本線  ·  高崎線",
"name:ko": "다카사키 선  ·  도호쿠 본선  ·  우쓰노미야 선",
"name:zh": "宇都宮線  ·  東北本線  ·  高崎線",
...

この例の場合、次のような transit フィーチャーのプロパティを考慮します。

  • kind - transit フィーチャーの一般的なタイプ。
  • kind_detail - このプロパティは、transit フィーチャーの kind の詳細情報を提供します。このパラメーターは、line ジオメトリー タイプの場合にのみ適用されます。
  • min_zoom - transit フィーチャーを表示するための推奨最小ズーム レベル。
  • sort_rank - 地図上のさまざまなタイプの transit フィーチャーの表示順序を優先させるために使用される値。sort_rank 値 が大きい transit フィーチャー は、sort_rank 値が小さい transit フィーチャーの上に表示されます。
  • name - このトランジット ライン セグメントで有効なすべてのルート名を並べ替えたドット区切りのリスト。この例では、路線に 宇都宮線、東北本線、高崎線 の 3 つの都市間ルートがあります。このパラメーターは、line ジオメトリー タイプの場合にのみ適用されます。
  • name:* - ローカライズされたルート名を並べ替えたドット区切りのリスト。たとえば、この例のルートは英語で Tohoku Line、Takasaki Line、Utsunomiya Line です。これらのルートは、ISO 639-1 の 2 文字の言語コードで識別される他の言語でも提供されます。

LOC 2：

...
"source": "ipc",
"kind": "train",
"kind_detail": "intercity",
"num_lines": 2,
"min_zoom": 8,
"logical_offset": 0,
"sort_rank": 436,
"ref": ";東北本線;",
"name": "東北本線",
"name:en": "Tohoku Line",
"name:ja": "東北本線",
"name:ko": "도호쿠 본선",
"name:zh": "東北本線",
"colour": "#00BB85",
"direction": "F",
"operator": "101037_a7e604b",
...
...
"source": "ipc",
"kind": "train",
"kind_detail": "intercity",
"num_lines": 2,
"min_zoom": 8,
"logical_offset": 1,
"sort_rank": 436,
"ref": ";高崎線;宇都宮線;",
"name": "宇都宮線  ·  高崎線",
"name:en": "Takasaki Line  ·  Utsunomiya Line",
"name:ja": "宇都宮線  ·  高崎線",
"name:ko": "다카사키 선  ·  우쓰노미야 선",
"name:zh": "宇都宮線  ·  高崎線",
"colour": "#FF871C",
"direction": "F;F",
"operator": "101037_a7e604b;101037_a7e604b",
...

この例の場合、次のような transit フィーチャーのプロパティを考慮します。

  • kind - transit フィーチャーの一般的なタイプ。
  • kind_detail - このプロパティは、transit フィーチャーの kind の詳細情報を提供します。このパラメーターは、line ジオメトリー タイプの場合にのみ適用されます。
  • min_zoom - transit フィーチャーを表示するための推奨最小ズーム レベル。
  • sort_rank - 地図上のさまざまなタイプの transit フィーチャーの表示順序を優先させるために使用される値。sort_rank 値 が大きい transit フィーチャー は、sort_rank 値が小さい transit フィーチャーの上に表示されます。
  • name - このトランジット ライン セグメントで有効な、同じ colour のルート名のドット区切りのリスト。この例では、最初の都市間路線フィーチャーには 都市間ルート 東北本線 が 1 つあり、2 番目のフィーチャーには 宇都宮線と高崎線 の 2 つのルートがあります。このパラメーターは、line ジオメトリー タイプの場合にのみ適用されます。これはアルファベット順になっています。
  • name:* - ローカライズされたルート名を並べ替えたドット区切りのリスト。たとえば、例のルートは英語で、最初のフィーチャーは Tohoku Line、2 番目のフィーチャーは Takasaki Line、Utsunomiya Line です。これらのルートは、ISO 639-1 の 2 文字の言語コードで識別される他の言語でも提供されます。
  • colour - このルートで有効なルートの色を表す 16 進値。この例では、トランジット セグメントに 2 つの異なる色の都市間ルートが 3 つあります。色ごとに異なるフィーチャーがあります。#00BB85 色の最初の都市間路線フィーチャーは 東北本線 (Tohoku Line) ルートに対応し、#FF871C 色の 2 番目のフィーチャーは 宇都宮線、高崎線 (Takasaki Line、Utsunomiya Line) ルートに対応します。
  • ref - このトランジット ライン セグメントで有効な、同じ colour のルート名をソース順に並べ替えたセミコロン区切りのリスト。このパラメーターは、line ジオメトリー タイプの場合にのみ適用されます。
  • direction - パラメーター direction は、特定のラインの色に対してライン セグメントで有効なルートのすべての方向を指定します。この値はセミコロン区切りで提供され、次の表記規則が使用されます。
    • F はルートの順方向を表します。
    • B はルートの逆方向を表します。
    • 空の値は、ルートに両方の方向があることを表します。

方向の値は ref パラメーターの値に対応しており、所定の順序で照合されます。

たとえば、direction が ";F" に設定されている場合、最初のルートは両方向に有効ですが、2 番目のルートは順方向にのみ有効です。

このパラメーターは、line ジオメトリー タイプの場合にのみ適用されます。

  • text_colour - この路線で有効なルートの参照値のテキストを表示するのに使用される色。形式は colour と同じです。このパラメーターは、line ジオメトリー タイプの場合にのみ適用されます。
  • operator - 特定の色に対してこのライン セグメントで有効なルートのオペレーター ID のセミコロンで区切られたリスト。(例："operator": "101037_a7e604b;101037_a7e604b")。1 つ目のオペレーター ID は 高崎線 (Takasaki Line) ルート、2 つ目のオペレーター ID は 宇都宮線 (Utsunomiya Line) ルートに対応しています。
  • logical_offset - 0 から num_lines までの範囲内で、同じ kind と kind_detail を持つセグメント内のすべてのラインにわたって計算されたライン オフセットです。 この例では、最初の都市間路線フィーチャーには "logical_offset": 0 があり、2 番目のフィーチャーには "logical_offset": 1 があります。このパラメーターは、line ジオメトリー タイプの場合にのみ適用されます。
  • num_lines - 同じ kind と kind_detail を持つセグメント内のライン フィーチャーの数。 この例では、セグメントに異なる色を持つ 2 つのライン フィーチャーがあるため、各フィーチャーの属性は "num_lines": 2 になります。

transit レイヤーの kind と sort_rank の値

以下は、transitレイヤーフィーチャーのkind値と対応するsort_rank値のリストです。

HERE Vector Tile APIで使用可能な地図パラメーターの詳細については、「地図パラメーター」を参照してください。

  • railway_station_platform - (sort_rank:385) - 駅のプラットフォーム。
  • subway_station_platform - (sort_rank:385) - 地下鉄駅のプラットフォーム。
  • funicular (sort_rank:430) - 急斜面でケーブルカーを使用する交通機関システム。
  • monorail (sort_rank:431) - 列車が単線を走行する鉄道システム。
  • subway (sort_rank:432) - 都市部で一般的に見られる地下鉄または高架鉄道システム。
  • light_rail (sort_rank:429, 433) - 少ない乗車定員で運行し、他の車両と線路を共有する都市鉄道輸送のタイプ。実際の sort_rank 値は、このフィーチャー インスタンスの特定の kind_detail に依存します。
  • train (sort_rank:382, 435, 436, 437, 445, 446) - 線路を利用する輸送手段を指す一般用語。一般的に都市間や地域間の移動に使用されます。実際の sort_rank 値は、このフィーチャー インスタンスの特定の kind_detail に依存します。
  • aerial (sort_rank:442) - ロープウェイやゴンドラなど、地上レベルよりも上で運行する交通機関システム。
  • ferry (sort_rank:411) - 短距離および長距離の船舶サービスを運営する交通機関システム。
  • air (sort_rank:443) - 航空会社などの空中で運行される交通機関システム。

transit レイヤーの kind_detail と sort_rank の値

これらのkind_detail値は、transitフィーチャータイプに関する追加情報を提供します。 HERE Vector Tile APIで使用可能な地図パラメーターの詳細については、「地図パラメーター」を参照してください。

  • tram (sort_rank:429) - light_rail kind の路面電車の路線を表します。
  • suburban (sort_rank:433) - light_rail kind の郊外の鉄道路線を表します。
  • funicular (sort_rank:430) - funicular kind のケーブルカー路線を表します。
  • monorail (sort_rank:431) - monorail kind のモノレール路線を表します。
  • subway (sort_rank:432) - subway kind の地下鉄路線を表します。
  • train (sort_rank:382) - train kind のその他の鉄道路線を表します。
  • regional (sort_rank:435) - train kind の地方鉄道路線を示します。
  • intercity (sort_rank:436) - train kind の都市間鉄道路線を表します。
  • high_speed (sort_rank:437) - train kind の高速鉄道路線を表します。
  • touristic (sort_rank:444) - train kind の観光用鉄道路線を表します。
  • tram_touristic (sort_rank:445) - train kind の観光用路面電車の路線を表します。
  • airport_terminal (sort_rank:446) - train kind の空港ターミナル路線を表します。
  • aerial (sort_rank:442) - aerial kind のケーブルカーまたはゴンドラの路線を表します。
  • ferry (sort_rank:411) - ferry kind の短距離および長距離の船の航路を表します。
  • air (sort_rank:443) - air kind の航空路線を示します。

次のステップ

  • HERE Vector Tile APIで使用できる他のレイヤーフィーチャータイプの詳細については、「タイルレイヤー」を参照してください。

5 時間前の更新