ガイドAPIリファレンス
ガイド

Advanced Vector Tile

HERE Vector Tile APIではトランザクションごとの支払いモデルが採用されており、タイルのリクエスト (トランザクション) の数に基づいて料金が請求されます。リクエストされたフィーチャーの種類も価格に影響するもう1つの要因です。リクエストで特定の高度なフィーチャーを使用すると、アカウントが異なる価格カテゴリーに配置され、HEREのトランザクションごとの支払いモデルに従って追加料金が発生する可能性があります。

HERE Vector Tile APIでは、高度な施設情報や高度な道路などのオプションコンテンツを含むタイルリクエストは、HERE Map RenderingのAdvanced Vector Tileの価格設定カテゴリーに分類されます。

詳細については、HEREプラットフォームの価格設定を参照してください。

高度な施設情報

高度な施設情報レイヤーは、追加の PDS カテゴリーの POI を使用してデフォルトの pois レイヤーを拡張します。

高度なPOIを含むレイヤーをリクエストするには、次の例に示すような値を持つcontentパラメーターをクエリに追加します:content=default,advanced_pois

📘

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

高度な共有プロパティ

  • chain - チェーンの一意の識別子。
  • pds_id - domain:system:type:id形式の一意の場所識別子 (例:here:cm:place:1a2b3c4d5e)。

追加の場所の詳細を取得するには、lookupH.service.SearchServiceインターフェースを使用できます。

📘

idプロパティは非推奨であり、2025年3月31日に削除されます。代わりにpds_idを使用します。

PDSカテゴリー

次の PDS カテゴリーは、高度な POI (施設情報) の一部です。

  • 400-4100-0326 - 料金所 (toll_booth kind)
  • 400-4200-0048 - ウェイトブリッジ (weigh_station kind)
  • 400-4200-0049 - 貨物センター (cargo_transportation kind)
  • 400-4200-0050 - 鉄道操車場 (cargo_transportation kind)
  • 400-4200-0051 - 港または港湾 (harbour kind)
  • 400-4200-0052 - 空港貨物センター (cargo_transportation kind)
  • 400-4200-0241 - 貨物輸送 (cargo_transportation kind)
  • 400-4200-0311 - 配送入口 (delivery_entrance kind)
  • 400-4200-0312 - 商品・資材搬入口 (loading_zone kind)
  • 400-4200-0313 - 貨物積み下ろしエリア (loading_zone kind)
  • 700-7600-0322 - 電気自動車 (EV) 充電スタンド。charging_stationの種別を持ち、E-Mobility Service Provider (eMSP) 名kind_detail値に関連付けられています。
  • 700-7600-0323 - トラック用の電気自動車 (EV) 充電スタンド。charging_stationの種別を持ち、eMSPkind_detail値に関連付けられています。
  • 700-7600-0324 - 二輪用の電気自動車 (EV) 充電スタンド。charging_stationの種別を持ち、eMSPkind_detail値に関連付けられています。
  • 700-7600-0325 - 電気自動車 (EV) バッテリー交換ステーション。charging_stationの種別を持ち、eMSPkind_detail値に関連付けられています。
  • 700-7850-0126 - トラック修理 (car_repair kind)
  • 700-7900-0000 - トラック&セミトラック ディーラー・サービス(carKind)
  • 700-7900-0130 - トラック販売 (car kind)
  • 700-7900-0131 - トラック駐車場 (parking kind)
  • 700-7900-0132 - トラック乗り場またはプラザ (parking kind)
  • 700-7900-0323 - トラック洗車 (car_wash kind)
📘

電気自動車充電所のkind_detail属性には、eMSP (E-Mobility Service Provider) の名前が含まれています。

次の図は、電気自動車充電所を表す高度なポイントと、関連するベクターデータをJSON形式で示すサンプルです。

高度なPOI - 電気自動車充電所

高度な道路レイヤー

高度な道路レイヤーは、重量物運搬車 (HGV) 向けに特別に調整された地図機能を提供する高度なプロパティを使用して、roadsレイヤーを拡張します。これらの Premium プロパティは、ルートの最適化、ナビゲーションの改善、HGV 固有の要件への準拠を確実にするための貴重な情報を提供します。

このレイヤーをリクエストするには、次の追加クエリ パラメーターを指定します:content=default,advanced_roads。 高度な道路レイヤーのコンテンツには、次の定義があります。

  • レイヤー名: roads
  • ジオメトリー タイプ:linepoint

このレイヤーには、roads レイヤーと同じデータと、次の新しいプロパティが含まれています。

  • hgv - 一般的な重量物運搬車のアクセスを示します。Line ジオメトリーでのみ使用できます。値にはnoおよびdeliveryがあります。

    📘

    hgvプロパティに値noがある場合、その道路にはhgv_restrictionプロパティとhgv_restriction_shield_textプロパティはありません。他のケースでは、道路にhgv_restrictionプロパティとhgv_restriction_shield_textプロパティを設定できます。delivery hgv値は、道路がトラックの一時的な通行には禁止されているが、配達は許可されていることを示します。

  • hgv_restriction - この任意のプロパティは、重量物運搬トラックのアクセス制限を示します。PointLine の両方のジオメトリーで使用できます。詳細については、「hgv_restriction」と hgv_restriction_shield_text プロパティの定義を参照してください。

  • hgv_restriction_shield_text - この任意のプロパティは必ず hgv_restriction とセットで使用され、重量物運搬車のアクセス制限を示します。制限によって単位が異なるため、5.1m または 16'9" (米国)、4t または 4.4 T (米国) のように、値の横に略語が表示されます。これらの値は小数第 1 位まで指定されますが、5.0m の場合、値は 5m となります。詳細については、「hgv_restriction_shield_text」を参照してください。

  • hgv_time_restrictions - この任意のプロパティは、重量物運搬車のアクセスが制限される期間を指定します。詳細については、「hgv_time_restrictions」を参照してください。

  • hgv_direction - この任意のプロパティは、制限が一方通行であることを示し、道路線に対する方向を指定します。このプロパティは、前方 F または後方 B にできます。

  • hgv_road_kind - このプロパティはPointフィーチャーに対してのみ使用でき、制限が適用されている道路のkindプロパティを反映します。

  • hgv_road_kind_detail - このプロパティはPointフィーチャーに対してのみ使用でき、制限が適用されている道路のkind_detailプロパティを反映します。

  • toll_hgv - 通行料金が特定のクラスの重量物運搬車に適用されるかどうかを示すオプションのブール型プロパティ。このプロパティは、値が true の場合にのみ存在します。

  • toll_hgv_time_restrictions - 常に toll_hgv プロパティとペアになるオプションのプロパティで、HGV アクセス料金が徴収される期間を示します。

  • all_hgv_restrictions - このプロパティは常にall_shield_textsプロパティとペアになっており、セミコロンで区切られた (;) hgv_restriction値のリストが含まれます (hgv_restriction : multiple の場合のみ)。

  • all_hgv_restriction_shield_text - このプロパティは常にall_hgv_restrictionsプロパティとペアになっており、セミコロンで区切られた (;) hgv_restriction_shield_text値のリストが含まれます (hgv_restriction : multiple の場合のみ)。

  • all_hgv_time_restrictions - このプロパティは常にall_hgv_restrictionsプロパティとペアになっており、セミコロンで区切られた (;) hgv_time_restrictions値のリストが含まれます (hgv_restriction : multiple の場合のみ)。

  • all_tpr - 車両の交通量が多い場合に承認され推奨される、道路または歩道を指定するためのオプションのプロパティです。セミコロン (;) で区切られたtprコードのリストが含まれています。たとえば、all_tpr: "21;27;30"は、この道路が次の大型車両タイプに推奨されていることを意味します:21 - PBS Level 2A、27 - B-Double、General Mass Limits (GML) に基づき長さ23メートル以下、30 - B-Double、Higher Mass Limits (HML) に基づき長さ26メートル以下。サポートされている値と説明はこちらのリンクから確認できます。

  • hgv_applied_to_delivery - 制限が配達トラフィックと通過トラフィックに適用されるかどうかを示すオプションのプロパティです。このプロパティは、値が false の場合にのみ存在します。

  • all_hgv_applied_to_delivery - 複数の規制がある道路のオプションのプロパティで、セミコロンで区切られた (;) hgv_applied_to_delivery値のリストが含まれます (hgv_restriction : multipleの場合のみ)。

  • hgv_gross_weight_mass - これはオプションのプロパティで、常にweightに設定されているhgv_restrictionプロパティと組み合わされ、重量制限のタイプを指定します。trueの場合、このプロパティは総車両質量 (GVM) 制限を示しています。falseの場合は現在の重量制限を示しています。このプロパティがないと、重量制限タイプが決定されません。

hgv_restriction

hgv_restriction プロパティは、重量物運搬車のアクセスに対する一般的な制約を示します。以下は使用できる値の一覧です。

  • weight - 最大積載時のトレーラーおよび出荷貨物を含む車両重量
  • height - 高さ制限
  • length - 長さ制限
  • width - 幅の制限
  • axles - 車軸数制限
  • kpra - キングピンから後輪車軸までの長さ制限
  • hazmat - 危険物を運搬する車両の制限
  • trailers - トレーラーの制限
  • other - その他の制限
  • multiple - 複数の制限がある場合 (ラインに沿ったポイントとして表示され、各ポイントがこの道路に適用される特定の制限を表します)

HGV総重量の制限:

  • wpan_two_axles - 2 軸 HGV の重量制限を指定します。
  • wpan_three_axles - 3 軸 HGV の重量制限を指定します。
  • wpan_four_axles - 4 軸 HGV の重量制限を指定します。
  • wpan_five_axles - 5 軸 HGV の重量制限を指定します。
  • wpan_six_axles - 6軸HGVの重量制限を指定します。
  • wpan_seven_axles - 7軸HGVの重量制限を指定します。
  • wpan_two_or_more_axles - 2軸以上のHGVの重量制限を指定します。
  • wpan_three_or_more_axles - 3軸以上の HGV の重量制限を指定します。
  • wpan_four_or_more_axles - 4軸以上の HGV の重量制限を指定します。
  • wpan_five_or_more_axles - 5 軸以上の HGV の重量制限を指定します。
  • wpan_six_or_more_axles - 6 軸以上の HGV の重量制限を指定します。

アクスル グループあたりの重量:

  • wpag_single_axle - シングル アクスル グループの HGV のアクスル グループごとの重量制限を示します。
  • wpag_tandem_axle - タンデム アクスル グループの HGV のアクスル グループごとの重量制限を示します。
  • wpag_triple_axle - トリプル アクスル グループの HGV のアクスル グループごとの重量制限を示します。
  • wpag_quad_axle - クワッド アクスル グループの HGV のアクスル グループごとの重量制限を示します。
  • wpag_quint_axle - クイント アクスル グループの HGV のアクスル グループごとの重量制限を示します。

禁止アクスル グループ:

  • axles_group_single_axle - シングル アクスル グループの HGV のアクセスを禁止します。
  • axles_group_tandem_axle - タンデム アクスル グループの HGV のアクセスを禁止します。
  • axles_group_triple_axle - トリプル アクスル グループの HGV のアクセスを禁止します。
  • axles_group_quad_axle - クワッド アクスル グループの HGV のアクセスを禁止します。
  • axles_group_quint_axle - クイント アクスル グループの HGV のアクセスを禁止します。

これらの拡張値は、重量制約、アクスル グループごとの重量制約、特定の車軸構成での禁止されたアクセスに関する詳細情報を提供します。これらの値により、ユーザーは、HGV が重量制約に準拠しているかどうか、および特定の車軸構成が特定の道路または特定のエリア内で許可されているかどうかを正確に評価できます。

次の図は、HGV 制約のある道路のベクター データのサンプルです。

HGV 制約のあるベクター データのサンプル

hgv_restriction_shield_text

HERE Vector Tile APIでは次のHGV関連の標識テキスト値を使用できます。 weight制限

  • weight value - 値。たとえば 4t または 4.4 T (米国) など

heightlengthwidthkpra 制限

  • dimensions value - 高さ、長さ、または幅の値。たとえば5.1mまたは16'9" (米国、英国) など

wpa (軸重) 制限

  • weight value - たとえば、1.8t または 2 T (米国) など

axles 制限

  • Two or more axles
  • Three or more axles
  • Four or more axles
  • Five or more axles
  • Six or more axles

hazmat 制限

  • Hazardous material type unknown
  • Unspecified hazardous material type
  • Explosives
  • Gas
  • Flammable
  • Flammable solid combustible
  • Organic
  • Poison
  • Radioactive
  • Corrosive
  • Other
  • Any hazardous material
  • Poisonous inhalation hazard
  • Goods harmful for water
  • Explosive and flammable
  • Tunnel category b
  • Tunnel category b1000c
  • Tunnel category b d
  • Tunnel category b e
  • Tunnel category c
  • Tunnel category c5000d
  • Tunnel category c d
  • Tunnel category c e
  • Tunnel category d
  • Tunnel category d e
  • Tunnel category e

trailers 制限

  • One or more
  • Two or more
  • Three or more
  • Semi or tractor with trailers

multiple制限には、関連する道路のkindプロパティとkind_detailsプロパティに対応する値を持つhgv_road_kindプロパティとhgv_road_kind_detailプロパティがあります。 other 制限と multiple 制限では hgv_restriction_shield_text は省略されます。

hgv_time_restrictions

このプロパティは、条件が適用される日付と時間を指定します。値は、GDF (地理データファイル) 仕様の一部であるタイム ドメイン形式に従ってフォーマットされた文字列です。GDF 標準の現在のバージョンは 5.1 で、ISO 20524-1:2020 に対応しています。

基本的なタイム ドメインは開始日と期間で表され、[(Starting Date) {Time duration}] の形式で表示されます。たとえば、[(M5d1){d1}] という表記は以下を意味します。

  • 開始日:任意の年の 5 月の 1 日目の午前 12 時 (深夜) から開始します。
  • 期間:期間は 1 日間続き、24 時間 (1440 分) に相当します。

開始日と期間は、年、月、週、日、さらには秒など、さまざまな時間単位を表現できる図記号を使って表示されます。

これらの記号は、最も長い時間単位から最も短い時間単位へと順に配置されます。これらのシンボルを開始日と組み合わせると、基本的なタイム ドメインになります。

開始日が指定されていない場合、表記は期間のみを表します。期間セクションの最初の時間タイプ コードの前にマイナス記号が付く場合は、期間が逆にカウントされることを意味します。 以下のリストは、開始日時と期間の単位タイプの説明です。

  • ynn - 年を表します。この記号は特定の年を示し、nnnn として開始日に含めて示したり、nn 年の期間を示したりすることができます。たとえば、[(y1991M11d14h5m30s19){y1}] という表記は、1991 年 11 月 14 日の午前 5 時 30 分 19 秒から 1992 年 11 月 14 日の午前 5 時 30 分 19 秒までの期間を表します。2 月 29 日のように指定された年に対応する暦日がない場合、1 年を追加すると該当する日付は翌年の 2 月 28 日と見なされます。なお、{y1}{M12} は 1 年の期間という意味では同等です。
  • Mnn - 月を表します。開始日に年の情報が含まれている場合、指定された年の特定の月 (1 から 12 まで) を表すことができます。y 情報が指定されていない場合は、任意の年を表すことができます。または、nn か月の期間を表すこともできます。

たとえば、[(y1991M11d14h5m30s19) {M3}] という表記は、1991 年 11 月 14 日午前 5 時 31 分 19 秒から 1992 年 2 月 14 日午前 5 時 30 分 19 秒までの期間を表します。これは 1991 年 11 月から 1992 年 2 月までの 3 か月の期間を示しています。

  • wnn - 週を表します。開始日に年の情報が含まれている場合、指定された年の特定の週 (1 から 53 まで) を表すことができます。y 情報が指定されていない場合は、任意の年を表すことができます。また、nn 週間の期間を示すこともできます。これは nn * 7 日と同等です。

たとえば、[(y1991M11d14h5m30s19) {w2}] という表記は、1991 年 11 月 14 日午前 5 時 30 分 19 秒から 1991 年 11 月 28 日午前 5 時 30 分 19 秒までの期間を表します。これは、指定された日付から 14 日間続く 2 週間の期間を表します。{w1}{d7} は、いずれも 1 週間 (つまり 7 日間) の期間を表しているため同等です。

  • dnn - 日を表します。開始日に M 形式で月の情報が含まれている場合、指定された月の特定の日 (1 から 28、29、30、または 31 まで) を表すことができます。または、nn 日の期間を表すこともできます。これは nn * 24 時間と同等です。

たとえば、[(y1991M11d14h5m30s19) {d2}] という表記は、1991 年 11 月 14 日午前 5 時 30 分 19 秒から 1991 年 11 月 16 日午前 5 時 30 分 19 秒までの期間を表します。これは、指定された日付から 48 時間続く 2 日間の期間を表します。{d1}{h24} は、いずれも 1 日 (つまり 24 時間) の期間を表しているため同等です。

  • tn - 開始日に含まれ、曜日を表します。数値を使って特定の曜日を指定するのに使用されます。1 は日曜日、2 は月曜日、3 は火曜日、4 は水曜日、5 は木曜日、6 は金曜日、7 は土曜日を表します。この表記は開始日内でのみ使用され、該当する場合は、あらかじめ定義された週の曜日を定義します。

たとえば、(M5t2) は、任意の年の 5 番目の月 (5 月) の午前 12 時から始まる毎週月曜日を意味します。これは、年に関係なく、5 月にあるすべての月曜日に条件が適用されるということです。

  • fxn - この記号は開始日に含めて使用され、あらかじめ定義された月の特定の曜日を指定します。形式は次のルールに従います。

    • 変数 n は、上記の「t」形式と同様に、1 (日曜日) から 7 (土曜日) までの曜日を表します。
    • 変数 x は、その月の最初の当該の曜日を指定する場合は 1、2 回目は 2、3 回目は 3、4 回目は 4、5 回目は 5 に置き換えられます。 たとえば、(...f12) は 1 回目の月曜日の午前 12 時を表します。これは、あらかじめ定義された月の最初の月曜日に条件が適用されることを意味します。
  • lxn - この記号は、あらかじめ定義された月の特定の曜日を指定するために使用されます。形式は次のルールに従います。

    • 変数 n は、上記の「t」形式と同様に、1 (日曜日) から 7 (土曜日) までの曜日を表します。
    • 変数 x は、1 回目の当該の曜日を指定する場合は 1、2 回目は 2、3 回目は 3、4 回目は 4、5 回目は 5 を選択します。これらの値は月末から逆順で割り当てられ、その月の最終日から何回目にあたるかを示します。

    たとえば、(...l12) は最後の月曜日の午前 12 時を表します。

  • hnn - 時間を表します。開始日の中で日があらかじめ定義されている場合は、特定の日の特定の時間 (0 から 23 まで) を表すことができます。または、nn 時間の期間を示すこともできます。これは nn * 60 分と同等です。

    たとえば、[(y1991M11d14h5m30s19) {h10}] は 1991 年 11 月 14 日の午前 5 時 30 分 19 秒から 1991 年 11 月 14 日の午後 3 時 30 分 19 秒までの期間を表します。これは、指定された時間に始まり 10 時間後に終了する 10 時間の期間を表します。{h1}{m60} は、いずれも 1 時間 (つまり 60 分) の期間を表しているため同等です。

  • mnn - 分を表します。開始日の中で時間があらかじめ定義されている場合は、特定の時間の特定の分 (0 から 59 まで) を表すことができます。または、nn 分の期間を表すこともできます。これは nn * 60 秒と同等です。

    たとえば、[(y1991M11d14h5m30s19) {m11}] は 1991 年 11 月 14 日午前 5 時 30 分 19 秒から 1991 年 11 月 14 日午前 5 時 41 分 19 秒までの期間を表します。これは 11 分の期間を表します。{m1}{s60} は、いずれも 1 分 (つまり 60 秒) の期間を表すため同等です。

  • snn - 秒を表します。開始日の中で分があらかじめ定義されている場合は、特定の分の特定の秒 (0 から 59 まで) を表すことができます。または、nn 秒の期間を表すこともできます。

    たとえば、[(y1991M11d14h5m30s19) {s21}] は、1991 年 11 月 14 日午前 5 時 30 分 19 秒から 1991 年 11 月 14 日午前 5 時 30 分 40 秒までの期間を示します。これは 21 秒の期間を表します。{m1}{s60} は、いずれも 1 分 (つまり 60 秒) の期間を表すため同等です。

  • znn - 特殊な期間のあいまい記号を表します。現在、次の 2 つのバリエーションが使用されています。

    • [(z1){z51}] は「夜明けから夕暮れまで」、つまり夜間を意味します。
    • [(z2){z52}] は「夕暮れから夜明けまで」、つまり日中を意味します。

    これらのあいまい記号の使用法と解釈は、コンテキストや今後の仕様の拡張によって異なる場合があります。

  • string_value - 外部指定された文字列値。たとえば、[*EASTER(h8){h14}] はイースター期間中の午前 8 時から午後 10 時までを意味します。

複数の時間単位で構成される開始日 (たとえば 1991 年 11 月 14 日) は、記号を階層順に並べて配置することによって定義されます。

複数の時間間隔単位で構成される期間 (継続時間) は、個々の記号を階層順に並べてリスト表示することで表されます。特定の記号の組み合わせの合計時間は、各時間間隔の合計です。

たとえば、{y2M1w2} は 2 年 1 か月と 2 週間の期間を意味します。タイム ドメインはここで説明した最小の時間単位、つまり秒の集合と見なせるため、次のような集合演算と組み合わせることもできます。

  • 和集合の記号:+
  • 積集合の記号:*
  • 差集合の記号:-

すべてのタイム ドメイン文字列は前置表記で保存されます。前置表記では前置記法 (ポーランド記法) が使用されるため、冗長になる括弧が省略されます。

例:

  • [[(d1){w1}]-[(d3){d1}]] の前置表記は -(d1){w1}(d3){d1}
  • [[(d1){w1}]*[(d3){-w1}]] の前置表記は *(d1){w1}(d3){-w1}

次の図に、高度なプロパティを使用して拡張された道路フィーチャーの例を示します。 スウェーデン、ストックホルムの道路の高度な道路プロパティ

この例では、高度な toll_hgv プロパティと toll_hgv_time_restrictions プロパティで示されているように、特定の時間、曜日、月に、HGV 車に対してタイム ドメイン形式で指定されたとおりに料金が適用されます。

次のステップ

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