ネットワーク制限のあるトラック

📘
注
現在この機能はベータ版です。

networkRestrictedTruck移動モードでは、特定の道路ネットワークのみを走行することが許可されたトラックのルートを計算できます。
これらのネットワークは通常、国または州レベルで指定されるもので、承認された道路において特定の大型車両構成の走行を許可します。たとえば、ニュージーランドのHPMV (高生産性自動車) や、オーストラリアのB-DoubleおよびPBS (性能基準) ネットワークがこれに該当します。

ネットワーク制限のあるトラックのルートを計算するには、transportMode=networkRestrictedTruckを設定し、networkRestrictedTruck[permittedNetworks]パラメーターを使用して、走行が許可されている道路ネットワークを指定します。ルート計算では、指定されたネットワークが可能な限り使用されます。

fastルーティングモードのみがサポートされます。

許可されたネットワークパラメーター

permittedNetworksパラメーターはnetworkRestrictedTruck移動モードを使用する場合に必須です。このパラメーターでは、トラックの走行が許可される道路ネットワークを指定します。

値は、パイプ記号 (|) で区切られたエントリーのリストです。各エントリー内は、コロンで区切られたフィールドで構成されます。

{country}:{state}[,state]...:{network}[,network]...

説明：

{country} — ISO 3166-1 alpha-3の国コード (例：NZL、AUS)
{state} - ISO 3166-2の州/territoryのコード (例：NSW、QLD)。国全体で共通のネットワークのみを使用する国では省略されます。
{network} - 以下の対応リストにある、1つ以上のネットワークコード

対応ネットワーク

ニュージーランド (NZL) のネットワークは国全体で定義されていますが、オーストラリア (AUS) のネットワークは州/territoryごとに定義されています。

📘
注
対応ネットワークの全リストについては、「APIリファレンス」を参照してください。

ネットワーク制限のあるトラックとトラックルートの比較

ネットワーク制限のあるトラックモードのルートは、許可されたネットワークを優先し、それらのネットワークに含まれない道路を回避するため、通常のトラックルートとは異なります。以下では、各モードでの類似したルートのリクエストについて考えます。

ニュージーランドのHPMVネットワーク (青色で表示) での走行が許可されたトラックのルートをリクエストします。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=-36.122043,174.330261&'\
'destination=-36.845039,174.778915&'\
'transportMode=networkRestrictedTruck&'\
'networkRestrictedTruck[permittedNetworks]=NZL:hpmv&'\
'return=polyline,summary&'\
'spans=permittedNetworks&'\
'vehicle[grossWeight]=50000&'\
'vehicle[currentWeight]=50000&'\
'vehicle[height]=420&'\
'vehicle[width]=250&'\
'vehicle[length]=2000&'\
'vehicle[axleCount]=8&'\
'vehicle[trailerAxleCount]=4&'\
'vehicle[trailerCount]=1&'\
'apiKey=YOUR_API_KEY'

ニュージーランドの同じ地点間 (紫色で表示) における、通常のトラック (HPMVネットワークの制限を受けないトラック) のルートをリクエストします。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=-36.122043,174.330261&'\
'destination=-36.845039,174.778915&'\
'transportMode=truck&'\
'return=polyline,summary&'\
'vehicle[grossWeight]=50000&'\
'vehicle[currentWeight]=50000&'\
'vehicle[height]=420&'\
'vehicle[width]=250&'\
'vehicle[length]=2000&'\
'vehicle[axleCount]=8&'\
'vehicle[trailerAxleCount]=4&'\
'vehicle[trailerCount]=1&'\
'apiKey=YOUR_API_KEY'

返されたルートがどのように異なっているか、以下に注目してください。

これは、以下に示す橋がHPMVネットワークに含まれていないため、ネットワーク制限のあるトラックのルートでは回避される一方で、通常のトラックのルートにはその橋が含まれているためです。

許可されたネットワークスパン

networkRestrictedTruckモードでルートを計算する場合、ルートのすべてのセグメントが、指定した通行許可ネットワークでカバーされるとは限りません。異なる許可されたネットワークのセグメントを接続するため、トラックは一般道路を走行する必要が生じる場合があります。

リクエストにspans=permittedNetworksクエリパラメーターを追加すると、ルートの各セグメントに対するスパンレベルの詳細を含みレスポンスを取得できます。道路がリクエストしたどのネットワークにも含まれていないスパンには、"offPermittedNetworks": trueが付与されます。

このパラメーターは、前述の例にも含まれています。下図では、ルートの始点と終点でスパンが返されており、濃い青色で表示されています。

例

ニュージーランドのHPMVルート

ニュージーランドのHPMVネットワークでの走行が許可されたトラックのルートを計算します。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=-36.848461,174.763336&'\
'destination=-41.286460,174.776236&'\
'transportMode=networkRestrictedTruck&'\
'networkRestrictedTruck[permittedNetworks]=NZL:hpmv&'\
'vehicle[grossWeight]=50000&'\
'vehicle[currentWeight]=50000&'\
'vehicle[height]=430&'\
'vehicle[width]=255&'\
'vehicle[length]=2300&'\
'vehicle[axleCount]=9&'\
'vehicle[trailerAxleCount]=6&'\
'vehicle[trailerCount]=2&'\
'return=polyline,summary&'\
'apiKey=YOUR_API_KEY'

ニューサウスウェールズ州のオーストラリアB-Doubleルート

ニューサウスウェールズ州で、一般重量制限に基づく23mのB-Doubleトラックのルートを計算します。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=-33.868820,151.209296&'\
'destination=-32.926668,151.776001&'\
'transportMode=networkRestrictedTruck&'\
'networkRestrictedTruck[permittedNetworks]=AUS:NSW:bDouble23Gml&'\
'vehicle[grossWeight]=58000&'\
'vehicle[currentWeight]=58000&'\
'vehicle[height]=430&'\
'vehicle[width]=250&'\
'vehicle[length]=2300&'\
'vehicle[axleCount]=9&'\
'vehicle[trailerAxleCount]=6&'\
'vehicle[trailerCount]=2&'\
'return=polyline,summary&'\
'apiKey=YOUR_API_KEY'

ニューサウスウェールズ州と南オーストラリア州を横断するオーストラリアB-Doubleルート

同じネットワークが複数の州に存在する場合があることに注意してください。たとえば、一般質量制限に基づくB-Double 26mトラックのネットワークはニューサウスウェールズ州と南オーストラリア州の両方に存在し、同じネットワークコードbDouble26Gmlが使用されています。このネットワークで両州の走行が許可されたトラックのルートをリクエストするには、permittedNetworksパラメーターで両方のネットワークを指定する必要があります。たとえば、以下のリクエストでは、ニューサウスウェールズ州と南オーストラリア州の両方でB-Double 26m GMLネットワーク、および両州のPBS Level 2A/2Bの走行が許可されたトラックのルートをリクエストしています。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=-33.868820,151.209296&'\
'destination=-34.928499,138.600746&'\
'transportMode=networkRestrictedTruck&'\
'networkRestrictedTruck[permittedNetworks]=AUS:NSW:bDouble26Gml,pbs2A|AUS:SA:bDouble26Gml,pbs2B&'\
'vehicle[grossWeight]=63000&'\
'vehicle[currentWeight]=63000&'\
'vehicle[height]=430&'\
'vehicle[width]=250&'\
'vehicle[length]=2500&'\
'vehicle[axleCount]=9&'\
'vehicle[trailerAxleCount]=6&'\
'vehicle[trailerCount]=2&'\
'return=summary&'\
'apiKey=YOUR_API_KEY'

ここでは、各州で付随するネットワークの組み合わせが異なるため、bDouble26Gmlを両方のエントリーに含める必要があります。これらをAUS:NSW,SA:bDouble26Gml,pbs2A,pbs2Bのような1つのエントリーにまとめることはできません。このようにすると、pbs2AがSA、pbs2BがNSWでリクエストされていると誤って解釈されてしまいます。両州でネットワークが同一である場合、複数の州を含む1つのエントリーを使用できます (例：AUS:NSW,SA:bDouble26Gml)。

複数州のネットワーク

ニューサウスウェールズ州、ビクトリア州、クイーンズランド州にまたがるB-Triple GML道路ネットワークに加え、クイーンズランド州ではPBS3Aも使用するルートをリクエストします。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=-33.861403,151.210909&'\
'destination=-27.469771,153.025124&'\
'transportMode=networkRestrictedTruck&'\
'networkRestrictedTruck[permittedNetworks]=AUS:NSW,VIC:bTripleGml|AUS:QLD:bTripleGml,pbs3A&'\
'vehicle[grossWeight]=83000&'\
'vehicle[currentWeight]=83000&'\
'vehicle[height]=430&'\
'vehicle[width]=250&'\
'vehicle[length]=3500&'\
'vehicle[axleCount]=12&'\
'vehicle[trailerAxleCount]=9&'\
'vehicle[trailerCount]=3&'\
'return=polyline,summary&'\
'apiKey=YOUR_API_KEY'

州内の複数のネットワーク

オーストラリアのビクトリア州で、PBS Level 2AおよびPBS Level 2Bの道路ネットワークの走行が許可されたトラックのルートをリクエストします。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=-38.351769,141.611148&'\
'destination=-36.554707,146.730313&'\
'return=polyline,summary&'\
'transportMode=networkRestrictedTruck&'\
'networkRestrictedTruck[permittedNetworks]=AUS:VIC:pbs2A,pbs2B&'\
'spans=permittedNetworks&'\
'vehicle[grossWeight]=60000&'\
'vehicle[currentWeight]=60000&'\
'vehicle[height]=420&'\
'vehicle[width]=250&'\
'vehicle[length]=2600&'\
'vehicle[axleCount]=11&'\
'vehicle[trailerAxleCount]=7&'\
'vehicle[trailerCount]=2&'\
'apiKey=YOUR_API_KEY'

networkRestrictedTruck移動モードを使用する場合でも、車両の寸法、重量、トレーラー数や車軸数などの詳細情報を指定することをお勧めします。これにより、ルート計算時に該当する規制、制限速度、通行料金を考慮できるようになります。ルート検索では、指定されたnetworkRestrictedTruck[permittedNetworks]に基づいて車両パラメーターを推定することはありません。