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

カスタム道路ネットワークオーバーレイ - 廃止

📘

注

カスタムレイヤーとカスタムルート検索のサポートは廃止されました。

お客様は道路ネットワークへの変更や追加などを含む独自のプライベート地図を作成できます。

これらの地図はHEREの地図ネットワークに「オーバーレイ」し、HERE Route Matching API v8のルート検索やルートの照合動作を変更します。

オーバーレイ地図では、さらなる道路の追加、道路属性 (アクセス権、一方通行、重量制限、走行速度など)の変更、道路のブロックを行うことができます。

お客様はオーバーレイ地図を使用して、個人の施設内の道路、個々の荷降ろし所までのルート検索やルートの照合を可能にするか、 運行管理のために特定の道路をブロック/許可/優先できます。

カスタムマップをアップロードする

お客様は「オーバーレイ」形式で道路オーバーレイ地図をアップロード/updateできます。プライベート地図はHERE Route Matching API v8 REST呼び出しを介してアップロード/updatedできます。

リソース/v8/maps/overlays/uploadは、道路のアクセス許可を変更して道路を追加するオーバーレイをアップロードします。アップロードにはPOSTリクエストを使用してください。

リソース/v8/maps/list.htmlにはお客様のプライベート地図が一覧表示され、/v8/maps/layers/list.jsonには地図のレイヤーが一覧表示されます。

オーバーレイを介して変更された地図を提供する場合、HERE Route Matching API v8が変更をルーティング可能なバイナリ地図形式にコンパイルします。

Route MatchingではHEREの地図レイヤーの上にこれらのレイヤーを使用します。

📘

注

オーバーレイ地図はお客様のプライベート地図間で同じ形式で保存されますが、「v8/maps/overlays/upload」リソースを使用して作成、変更、削除することを強くお勧めします。

オーバーレイ地図とレイヤー

お客様は複数のオーバーレイ地図を作成、使用、更新できます。たとえば、廃棄物収集車の変更を含むオーバーレイ地図と、 オーバーサイズ輸送の変更を含む別の地図です。

ルート検索やルートの照合のリクエストでは、これらのオーバーレイ マップのいずれかを指定でき、地図属性とトポロジーを上書きまたは拡張します。

オーバーレイ マップには、個々の道路リンクに対する複数の追加と上書きが含まれます。

追加されたものは新しい道路リンクです。上書きとは、 道路リンク属性 (速度、許可されている車タイプ、走行方向など) の変更、 または道路リンクでの追加の通行/右左折規制 (トラックの重量制限、 トラックの長さに応じた右左折規制など) のいずれかです。

オーバーレイマップは、 HERE Route Matching API v8のルート検索レイヤーに対応するテーマ別レイヤーに編成されます。ルート検索は主に、 HERE Route Matching API v8のレイヤーLINK_FCN、ROAD_GEOM_FCN、LINK_ATTRIBUTE_FCN、 TURN_RESTR_FCN、TRUCK_RESTR_FCNに依存します。

例

ドイツのフランクフルトにあるアルテ ブリュッケの近く、その西部への新しい橋を挿入します。新しい橋は3.3トンに制限します。

  https://routematching.hereapi.com/v8/maps/overlays/upload?map_name=OVERLAYEXAMPLE1
  &overlay_spec=[
    { "op":"override",
      "shape":[[50.10765,8.68774],[50.10914,8.68771]],
      "layer":"LINK_ATTRIBUTE_FCN",
      "data":{"VEHICLE_TYPES":"0"}
    },
    { "op":"create",
      "shape":[[50.10937,8.68422],[50.10807,8.68525],[50.10737,8.68387]],
      "data":{"NAMES":"ENGBNDemo Road"}
    },
    { "op":"override",
      "shape":[[50.10937,8.68422],[50.10807,8.68525],[50.10737,8.68387]],
      "layer":"TRUCK_RESTR_FCN",
      "data":{"VEHICLE_TYPES":"truck", "WEIGHT_RESTRICTION":"3300"}
    }
  ]
  &storage=readonly
  &app_id=YOUR_APP_ID&app_code=YOUR_APP_CODE
📘

注

HTTPクライアントがブラケットをURLエスケープしない場合は、送信前に実行する必要があります。

サポートデモスイートのその他の例： ドロップ ダウン メニューの [Predefined Examples](事前定義された例) には、多数のオーバーレイ ユースケースがあります サポート デモ スイートでオーバーレイをすぐに試すことができます。

オーバーレイの記述形式

オーバーレイ地図は JSON 形式のファイルで記述されます。オーバーレイファイルを送信すると、 HERE Route Matching API v8レイヤーにコンパイルされ、 地図変化を含むレイヤーとともに別の地図として保存されます。

オーバーレイ記述ファイルの内容

オーバーレイ記述ファイルは JSON オブジェクトを持つ JSON 配列で構成されます。それぞれの JSONオブジェクトは1つの地図変更操作を記述します。

op フィールドは操作のタイプを指定する次の必須フィールドです。

  • op : create - 新しい道路リンクを作成します
  • op : override - 既存のリンク属性 (許可されている車タイプなど) の 属性値を変更するか、 リンクに制約 (条件) を追加します (トラックの重量制限など)。
  • op : restrict - リンクアクセスまたは右左折規制 (トラック固有の幅制限など) を追加するか、 リンクの既存の制約を上書きします。
  • op : areaoverride - このポリゴン領域内のすべての既存リンクの属性値を変更します

操作の他のフィールドを以下に示します。

📘

注

トラック制約を追加すると通行がさらに制約されるだけですが、既存の制約を上書きして緩和または削除することもできます。トラックの重量などの制約を削除するには、既存の制約を100トン制限で上書きします。

作成オブジェクトをオーバーレイする

既存の 2 つのリンク間に新しいリンクを作成できます。現在、 リンクジオメトリーとそれに対応する属性を指定できます。他のすべての リンク属性は、隣接する既存のリンクからコピーされます。既存のリンクは 常に新しいリンクが挿入されたポイントでカットされます。

新しいリンクはそれぞれの端で既存の (または他の新しい) リンクに接続することも、 一方の端が未接続 (デッドエンド) のままにすることもできます。

  • shape - 各図形ポイントがWGS-84度の緯度と経度の2つの要素の配列である図形ポイントの配列です。

    現在、最初と最後のポイントは既存のリンクにそれぞれ5メートルの許容範囲内で 収まる必要があります。これらのポイントの両方が同じリンク上に存在することはできません。

  • layer - リンクまたは新しい制約を挿入するレイヤーです。 現在、LINK_ATTRIBUTE_FCNレイヤーのみがサポートされています。

  • data - 属性と値のペアの地図です。

現在、VEHICLE_TYPE と TRAVEL_DIRECTION のみサポートされています。

TRAVEL_DIRECTIONは、B/F/T (双方向、参照ノードから駆動、 参照ノードへ駆動) またはBOTH/FORWARD/BACKWARD (双方向、シェイプポイントのシーケンス順序で駆動、 シーケンス順序に逆らって駆動) を使用して定義できます。

上書きオブジェクトをオーバーレイする

既存のリンクの属性、または一連の既存のリンクの属性を 修正できます。現在、次の属性がサポートされています。

  • shape - 各図形ポイントがWGS-84度の緯度と経度の2つの要素の配列である図形ポイントの配列です。 ジオメトリーは次のようにする必要があります。 既存のリンクのジオメトリーの近似一致。形状点は次のようになります。 省略。ジオメトリーが複数の接続されたリンクのパスを表している場合は、 これらすべてのリンクの属性が変更されます。
  • layer - リンク属性を変更する必要があるレイヤーです 。現在、LINK_ATTRIBUTE_FCN レイヤーと TRUCK_RESTR_FCN レイヤーがサポートされています。
  • data - 属性と値のペアの地図です。現在、レイヤー LINK_ATTRIBUTE_FCNではVEHICLE_TYPEおよびTRAVEL_DIRECTIONが サポートされています。レイヤーTRUCK_RESTR_FCNでは、属性VEHICLE_TYPES、 WEIGHT_RESTRICTION、HEIGHT_RESTRICTION、LENGTH_RESTRICTION、 WIDTH_RESTRICTION、MAX_WEIGHT_PER_AXLE、NUMBER_OF_AXLES、KPRA_LENGTH、 HAZARDOUS_MATERIAL_TYPE、HAZMAT_PERMIT_REQUIREDがサポートされています。
  • VEHICLE_TYPESは通過トラフィックを許可するかどうかを指定することもできます。

制約オブジェクトをオーバーレイする

既存のリンクで通行/turn規制を追加または変更できます。現在、 次の属性がサポートされています。

  • shape - 各図形ポイントがWGS-84度の緯度と経度の2つの要素の配列である図形ポイントの配列です。 ジオメトリーは次のようにする必要があります。 既存のリンクのジオメトリーの近似一致。形状点は次のようになります。 省略。形状が複数の接続されたリンクのパスを表している場合は、 ジオメトリーがマップ内の複数の接続されたリンクのパスを表す場合、制限はこれらすべてのリンクにわたるパスとして拡張されます。
  • 'data' - 属性のマップ/valueペア。現在のところ、 属性VEHICLE_TYPE、TRAVEL_DIRECTION、WEIGHT_RESTRICTION、 HEIGHT_RESTRICTION、LENGTH_RESTRICTION、WIDTH_RESTRICTION、 MAX_WEIGHT_PER_AXLE、NUMBER_OF_AXLES、KPRA_LENGTH、 HAZARDOUS_MATERIAL_TYPE、および HAZMAT_PERMIT_REQUIREDがサポートされています。レイヤー、 インデックス、属性の詳細については、 HERE Route Matching API v8ドキュメントを参照してください。
  • type - 「access」、「turn restriction」、「transport rdm」のいずれかになります (トラックの重量、高さ、長さなどの運転操作の制約)。
  • bidirectional - 通行制約のためのオプションのパラメーターです。「true」にすると制約が両方の走行方向に適用されます。

デフォルトは「false」で、シェイプポイントの順序で定義された方向に制約が適用されます。

📘

注

関連するレイヤー (TURN_RESTR_FC*またはTRUCK_RESTR_FC*) は自動的に決定されます。

例：リンク 833297602 (ドイツ、シュヴァンハイム、ラインラント通り、ロータリーの南) で午前 0 時から午前 7 時までの間に 2 メートルの高さ制限を設定します。 [{"op":"restrict","shape":[[50.08562,8.58945],[50.08447,8.58847]],"type":"access","bidirectional":"true","data":{"HEIGHT_RESTRICTION":"200","DATE_TIMES":"1:N:N:XXXXXXX ::0000:0700"}}] カスタムの右左折規制を設定することもできます。from-link、to-link、該当する車タイプ、日時を定義します。 例：[{"op":"restrict","shape":[[53.54742,9.99704],[53.54746,9.99765],[53.54999,9.99999]], "type":"7", "data":{"TIME_OVERRIDE":"0","VEHICLE_TYPES":"1","RDM_TYPE":"1"}}]

複合的にデジタル化された道路と単一方向を変更する

オーバーレイジオメトリーは、オプションで、複合的にデジタル化された道路の両方向に一致させることができます。

overlay.jsonファイル全体に対して有効にするには、リクエストパラメーターmultidigitized_handlingを使用します。

個々の道路セクションに対して有効にするには、操作パラメーターmultidigitizedHandlingを使用します。

一方通行を変更またはブロックする場合、ジオメトリーポイントが許可された進行方向に進む必要があります。 地図マッチングは道路上にジオメトリをマッチングするのを避けようとするため、違法な通行につながるからです。

これが不可能または不明な場合は、パラメーター"bidirectional"を使用して進行方向に関係なく道路にマッチングします。

エリア内のすべてのリンクを一括変更する

指定したポリゴン内に完全に含まれるすべての既存リンクの属性を修正できます。

現在、次の属性がサポートされています。

  • shape - 各図形ポイントがWGS-84度の緯度と経度の2つの要素の配列である図形ポイントの配列です。

    ジオメトリーは時計回りのポリゴンを作成する必要があります (穴なし、自己交差なし、縮退したサイズ0の部分なし)。

  • layer - リンク属性を変更する必要があるレイヤーです。現在、LINK_ATTRIBUTE_FCNレイヤーのみがサポートされています。

  • data - 「上書きオブジェクトをオーバーレイする」と同様

例 1：この領域のすべての道路を閉鎖します。 {"op":"areaoverride", "shape":[[50.09211,8.6143],[50.09234,8.61902],[50.08994,8.61958],[50.09002,8.61447]], "layer":"LINK_ATTRIBUTE_FC3", "data":{"VEHICLE_TYPES":"0"}} 例2：この領域の歩行者道路以外のすべての道路の速度を上げます。 {"op":"areaoverride", "shape":[[50.09211,8.6143],[50.09234,8.61902],[50.08994,8.61958],[50.09002,8.61447]], "layer":"LINK_ATTRIBUTE_FCN", "data":{"VEHICLE_TYPES":"1007", "SPEED_CATEGORY":"2"}} 1 つのオーバーレイ操作には最大で 500 リンクを含めることができます。より大規模な操作は、幾何学的に、または機能クラスによって、分割できます。

施設内の既存の道路を処理する

多くの場合、私道 (の一部) はHEREの道路ネットワークにすでに存在しています。

デフォルトでは、カスタム ジオメトリーが私道に接続されます。

ただし、カスタムジオメトリーが現在の道路ネットワークよりも詳細になり、優先される場合は、パラメーター &private_link_handling=DROPEXISTINGを使用して、新しいカスタムジオメトリーの周辺地にある 既存の私道リンクをブロックする (接続しない) ようにします。

その他に、既存の私道を保持するが接続はしないという選択肢もあります。

特定の道路リンクを回避または優先する

カスタム ルーティングでは、道路リンクに対するユーザー固有のペナルティまたはボーナスを考慮できます。

特定の道路が扱いにくい場合や、特定のタイプの運行管理車両に適している場合は、 カスタム道路オーバーレイを使用して、これらの道路を使用した場合の個々のペナルティまたはボーナスを定義できます。

例：[{"op":"restrict","shape":[[53.54742,9.99704],[53.54746,9.99765]], "type":"preferred", "data":{"VEHICLE_TYPES":"145","PREFERRED_ROUTE_TYPE":"201","ENTRY_PENALTY":-1,"DRIVE_PENALTY":-0.1}}] 負のペナルティ値を指定すると、ルート検索で特定のリンクが優先されます。

ペナルティまたはボーナスの値が多すぎると、レスポンス時間に影響が出る可能性があります。

ペナルティ/bonusはENTRY_PENALTYで構成されます。この値は、リンクを通過するための (ストレッチ) リンク /orまたはDRIVE_PENALTYのスローダウン係数 (あるいはその両方) を入力する固定 (秒) 値です。

type:preferredとPREFERRED_ROUTE_TYPE:201は地図内でアクセス条件"preferred route type" (タイプ27) を作成するため、 強制的に道路リンクを優先または回避します。

独自の制約タイプ (仮想交通標識など) を定義する

カスタムの値 (ベクター値) を使用して制約を設定できます。 たとえば、この道路リンクでは50kph以上が可能なクラス3+の車両のみが許可されます。

または、カスタムのバン/トラック/トレーラーのカテゴリー/プロパティ/地上高に応じて、特定の道路をブロックします。

(ストレッチ) リンクで[{"op":"restrict","shape": ... { ..., "CUSTOM_RESTRICTIONS":"0:100,1:90,2:60", ...}を使用して、 プロパティ#0が最大100、プロパティ#1が最大90、プロパティ#2が最大60の車のみを許可します。

ルート検索呼び出しでは、プロパティ #0 の値が 40、プロパティ #2 の値が 4 (およびプロパティ #1 が未定義) の車に &customRestrLimit=0:40,2:4 を指定します。

車タイプ

通行制約は特定の車タイプに適用されます。

車タイプは、"truck,bus,car"のような名前 (カンマ区切りリスト) で指定することも、対応する数値の車タイプのビットマスク (合計) として指定することもできます。

地図のドキュメント (https://smap.hereapi.com/v8/maps/layers/doc.html?layer=LINK_ATTRIBUTE_FC1&apikey=YOUR_API_KEY) では、 サポートされている車タイプがセクションVEHICLE_TYPESに示されています。

20 日前の更新