顧客のマップとカスタムマップの変更 - 独自のデータを取り込み
顧客は、道路ネットワーク への変更や追加を含む独自のプライベートマップを作成できます。 これらのマップは、 HERE マップネットワークに「オーバーレイ」し、 HERE Route Matching V8 のルーティング / ルートマッチング動作を変更します。 オーバーレイマップを使用すると、道路の追加、道路属性の変更 ( 通行許可、一方向の方向、重量制限、走行速度など ) 、道路のブロックを行うことができます。
顧客はオーバーレイマップを使用して、民間の施設内の道路、個々の荷降ろし場所までのルーティング / ルートマッチングを可能にしたり、車両に対する特定の道路のブロック / 許可 / 選択をします。
カスタムマップのアップロード
顧客は、「オーバーレイ」形式でロードオーバーレイマップをアップロード / 更新できます。 プライベートマップは、 HERE Route Matching V8 REST コールを介してアップロード / 更新できます。
resource/v8/maps/overlays/upload 道路の通行許可を変更して道路を追加するオーバーレイをアップロードします。 アップロードには POST リクエストを使用する必要があります。
resource /v8/maps/json list.html には、顧客のプライベートマップ、 /v8/maps/layers/list.json にマップのレイヤーが一覧表示されます。
オーバーレイを使用して変更されたマップを提供すると、 HERE Route Matching V8 によって変更内容がルーティング可能なバイナリマップ形式にコンパイルされます。 ルートマッチングでは、 HERE マップレイヤーの上にあるこれらのレイヤーが使用されます。
注
オーバーレイマップは顧客のプライベートマップ間で同じ形式で保存されますが、「 v8/maps/overlays/upload 」リソースを使用して、オーバーレイマップを作成、変更、および削除することを強くお勧めします。
マップとレイヤーのオーバーレイ
顧客は、複数のオーバーレイマップを作成、使用、および更新できます。 たとえば、 1 つのオーバーレイマップに廃棄物回収車両の変更を、もう 1 つのマップに超過サイズの輸送の変更を加えたものがあります。
ルーティング / ルートマッチングのリクエストでは、これらのオーバーレイマップのいずれかを指定でき、マップの属性およびトポロジを上書きまたは補強します。
オーバーレイマップには、個々の道路リンクに対する複数の追加および上書きが含まれています。
追加されたものは新しい道路リンクです。 オーバーライドは、ロードリンク属性の変更(速度、許可されている車両タイプ、走行方向など)、またはロードリンクに対する追加の通行 / 転回制限(トラックの重量制限やトラックの長さに応じた転回制限など)のいずれかです。
オーバーレイマップは、 HERE Route Matching V8 のルーティングレイヤーに対応するテーマ別レイヤーで編成されます。 ルーティングは主に、 HERE Route Matching 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 エスケープしない場合は、送信前にカッコをエスケープする必要があります。
サポートデモスイートのその他の例:
サポートでもスイート でオーバーレイをすばやく試すことができます。
オーバーレイマップは、 JSON 形式のファイルで記述されます。 オーバーレイファイルを送信すると、それらのファイルが HERE Route Matching V8 レイヤーにコンパイルされ、マップの変更が含まれているレイヤーとともに別のマップとして保存されます。
オーバーレイ記述ファイルの内容
オーバーレイ記述ファイルは、 JSON オブジェクトを含む JSON 配列で構成されています。 各 JSON オブジェクトは、 1 つのマップ変更操作を記述します。
op フィールドは、操作のタイプを指定する必須フィールドです。
-
op : create
–新しい道路リンクの作成 -
op : override
–既存のリンク属性 ( 許可されている車両タイプなど ) の属性値を変更するか、リンクに制限 ( 条件 ) を追加 ( トラックの重量制限など ) 。 -
op : restrict
–リンクアクセスまたは方向転換の制限を追加するか ( トラック固有の幅制限を含む ) 、リンクの既存の制限を上書きします。 -
op : areaoverride
- この多角形領域内の既存のすべてのリンクの属性値を変更します
操作の他のフィールドは、以下で指定します。
注
トラック制限を追加すると通行がさらに制限されるだけですが、既存の制限を上書きして緩和または削除することもできます トラックの重量などの制限を削除するには、既存の制限を 100 トンに上書きします。
オーバーレイオブジェクトの作成
2 つの既存のリンク間に新しいリンクを作成できます。 現在、リンク形状および対応する属性を指定できます。 他のすべてのリンク属性は、既存の隣接リンクからコピーされます。 既存のリンクは、常に新しいリンクが挿入された位置でカットされます。
新しいリンクは、両端で既存の(または他の新しい)リンクに接続するか、一方の端で未接続のままにしておく(デッドエンド)ことができます。
-
shape
–各図形ポイントが緯度と経度の 2 つの要素の配列である WGS-84 度の図形ポイントの配列。 現在、最初と最後のポイントは、それぞれ 5 メートル以内の許容範囲内で既存のリンクに適合する必要があります。 これらのポイントの両方が同じリンク上にあるとは限りません。
-
layer
–リンクまたは新しい制限を挿入する HERE Route Matching V8 レイヤーが現在 サポートされているのは、そのレイヤーLINK_ATTRIBUTE_FCN
のみです。
-
data
–属性と値のペアのマップ。 現在 VEHICLE_TYPE
およびTRAVEL_DIRECTION
のみがサポートされています。 レイヤー、インデックス、属性の詳細については、 HERE Route Matching V8 のドキュメントを参照してください。
TRAVEL_DIRECTION
B/F/T (双方向、参照ノードからのドライブ、参照ノードへのドライブ)または前後の両方を使用して定義できます(双方向、シェイプポイントのシーケンス順でのドライブ、シーケンス順でのドライブ)。
上書きオブジェクトをオーバーレイ
既存のリンクの属性、または既存のリンクのシーケンスの属性を変更できます。 現在、次の属性がサポートされています。
-
shape
–各図形ポイントが緯度および経度の 2 つの要素の配列である WGS-84 度の図形ポイントの配列。 形状は、既存のリンクの形状とほぼ一致する必要があります。形状点は省略できます。 ジオメトリがマップ内の複数の接続されたリンクのパスを示している場合、これらのすべてのリンクの属性が変更されます。 -
layer
–リンク属性を変更する必要がある HERE Route Matching V8 レイヤー。 現在 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
がサポートされています。 レイヤー、インデックス、属性の詳細については、 HERE Route Matching V8 のドキュメントを参照してください。 - 車両タイプでは、通過トラフィックを許可するかどうかを指定することもできます。
オーバーレイ制限オブジェクト
既存のリンクに通行 / 転回の制限を追加や変更することができます。 現在、次の属性がサポートされています。
-
shape
–各図形ポイントが緯度および経度の 2 つの要素の配列である WGS-84 度の図形ポイントの配列。 形状は、既存のリンクの形状とほぼ一致する必要があります。形状点は省略できます。 ジオメトリがマップ内の複数の接続されたリンクのパスを示している場合、制限はこれらのすべてのリンクのパスとして拡張されます。 - 'data' –属性と値のペアのマップ。 現在、属性
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 V8 のドキュメントを参照してください。 -
type
–「通行」、「転回制限」、または「トランスポート RDM 」のいずれかになります(トラックの重量、高さ、長さなど、運転操作には制限があります)。 -
bidirectional
–通行制限のためのオプションのパラメータ。 'true' を指定すると、制限が両方向に適用されます。 デフォルトは 'false' で、シェイプ点の順序で定義された方向に制限が適用されます。
注
関連するレイヤー(TURN_RESTR_FC*
または TRUCK_RESTR_FC*
)が自動的に決定されます。
例 : 2 m の高さの制限値を 833297602 リンクで 0 ~ 7 時に設定します ( ドイツ、シュワンハイム、ラインランダ通り、環状交差点の南 ) 。
[{"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 ファイル全体についてオンにするには、リクエストパラメータ "multidicated_handling" を使用します。 個々の道路セクションでオンにするには、操作パラメータ「 multidigitzedHandling 」を使用します。
一方通行を変更またはブロックする場合、ジオメトリポイントが許可された進行方向に進む必要があります。これは、マップマッチングでは、不正な通行/ 操作を引き起こす、道路上のジオメトリへのマッチングが回避されれるためです。 これが不可能な場合、または不明な場合は、パラメータ「 bidirectional 」を使用して、進行方向に関係なく道路にマッチングします。
領域内のすべてのリンクを一括変更
指定したポリゴン内に完全に存在するすべての既存のリンクの属性を変更できます。 現在、次の属性がサポートされています。
-
shape
–各図形ポイントが緯度 および経度 の 2 つの要素の配列である WGS-84 度の図形ポイントの配列。 ジオメトリは時計回りのポリゴンを作成する必要があります ( 穴なし、自己交差なし、縮退したサイズ0の部分なし ) 。 -
layer
–リンク属性を変更する必要がある HERE Route Matching V8 レイヤー。 現在 サポートされているのはレイヤーLINK_ATTRIBUTE_FCN
のみです。 -
data
– Overlay Override Object の場合と同様です
例 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}}]
負のペナルティ値を指定すると、ルーティングによって特定のリンクが優先されます ペナルティまたはボーナスの値が多すぎると、レスポンスタイムに影響が出る可能性があります。 ペナルティ / ボーナスは、 entry_pincipal で構成されます。この値は、リンクを通過するための ( ストレッチ ) リンクまたは drive_pincipal のスローダウン係数 ( またはそのいずれか ) を入力する固定 ( 秒 ) 値です。
「 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 の車両のみを許可します。 ルーティングコールでは &customRestrLimit=0:40,2:4
、プロパティ #0 の値が 40 で、プロパティ #2 の値が 4 のカー ( およびプロパティ #1) を指定します。
車両タイプ
特定の車両タイプには、通行制限が適用されます。 車両タイプは、「 TRACK 、 BUS 、 CAR 」のような名前(カンマ区切りリスト)で指定することも、対応する数値の車両タイプのビットマスク(合計)として指定することもできます。 マップのドキュメント では、セクション VEHER_TYPES でサポートされている車両タイプが示されています。