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

通行禁止制限

「通行禁止区域」とは、通行が禁止されている道路ネットワークのエリアを指します。 一般的な通行禁止制限である「居住者専用」の標識は、特定の車両が停車する目的でのみ、そのエリアに入ることが許可され、通過目的での利用は禁止されていることを示します。

HERE Routing API V8では、リクエストの出発地、目的地、中間経由地がそのような制限のあるエリア内にない限り、通行禁止区域を回避します。

適用される通行禁止制限は、ルート検索リクエストで使用される移動モードおよび車両パラメーターによって異なります。

APIレスポンスの通行禁止制限

場合によっては、対象が地域的および動的な性質を持つためにHERE Map Contentの通行禁止制限データが誤っていることがあります。 このため、Routing APIは通行禁止制限の違反通知を報告しません。制限があることだけを報告します。ただし、APIは違反の原因となるエリアを経由する経路を回避します。

APIレスポンスに通行禁止制限を含めるには、リクエストにreturn=noThroughRestrictionsを追加します。 計算されたルートでこれらの制限を特定するには、リクエストにspans=noThroughRestrictionsを追加して、通行禁止制限のあるスパンをリクエストします。

通行禁止制限を回避するルート検索

次の例は、通行禁止制限のあるエリアでのAPIの動作を示しています。 最初の例では、出発地と目的地は通行禁止区域の近くにありますが、その区域外にあります。 APIは制限を回避し、その周囲のルートを計算します。

2つ目の例では、目的地は通行禁止区域内に移動されています。 その結果、ルートはその区域を回避せず、レスポンスには制限の詳細を持つnoThroughRestrictionオブジェクトが含まれます。

例1:制限の回避

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.7490018,10.9137729&'\
'destination=52.717981,10.916049&'\
'return=polyline,summary,noThroughRestrictions&'\
'spans=noThroughRestrictions&'\
'transportMode=truck&'\
'vehicle[grossWeight]=8000&'\
'apiKey=YOUR_API_KEY'
{
  "routes": [
    {
      "id": "e93deab8-4c03-4478-938e-4cea1bd533c5",
      "sections": [
        {
          ...,
          "summary": {
            "duration": 485,
            "length": 6450,
            "baseDuration": 463
          },
          "polyline": "BGwgyzkD-mk6U7BqM_E8QvHgUnL4X3XkrBnVsnBjhB46Bv-BsyD34CkoF31BwrD_2GgzNvtCo8EztBo7C7uB44CzvFkmLze46Bj1B4iD_0C07EjmB8sCzUgtBrsBknDnao9BnQwlBrO0jBrO4rBjuC_kFjX3wB_EzK7VvvBjNvb3I7QjInL3I3I3IzFvHvC3I7BjcnBjDArETjDvCvC3DvC7GvCnL7B7L7GrxBvCjS7BvRvC3S7B_JjDvM3DrJvHjN_YnpB_EjInLvWvCnGjDzK3D3S3DnVzKjwBvH3hBvCzK3D3IrEvH_E7B_EnB3InBzFnBrJzFzF7G_J3N7ankB7a7kBjX7fjI7LjI3N_EjN_E_TvCjX3Dn4BnB3NjI_yD7VjqJjDvlBvC_TzFvlB3IvvBnLv0BrOrgC_drmEjSvyCvHriBzoBr4FjIvlBjIriBrErTzFrO7LzU_O3XpDzF",
          "spans": [
            {
              "offset": 0
            }
          ],
          "language": "en-us",
          "transport": {
            "mode": "truck"
          }
        }
      ]
    }
  ]
}
通行禁止区域は回避されます

例2:制限区域内の目的地

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.7490018,10.9137729&'\
'destination=52.745227,10.918257&'\
'return=polyline,summary,noThroughRestrictions&'\
'spans=noThroughRestrictions&'\
'transportMode=truck&'\
'vehicle[grossWeight]=8000&'\
'apiKey=YOUR_API_KEY'
{
  "routes": [
    {
      "id": "6a116225-0a74-4627-9b19-0da1683c1910",
      "sections": [
        {
          ...,
          "polyline": "BGwgyzkD-mk6U7BqM_E8QvHgUnL4X3XkrBnVsnBjhB46Bl4Eo5B",
          "spans": [
            {
              "offset": 0
            },
            {
              "offset": 7,
              "noThroughRestrictions": [
                0
              ]
            }
          ],
          "language": "en-us",
          "transport": {
            "mode": "truck"
          },
          "noThroughRestrictions": [
            {
              "type": "restriction",
              "maxGrossWeight": 7500,
              "maxWeight": {
                "value": 7500,
                "type": "gross"
              }
            }
          ]
        }
      ]
    }
  ]
}
通行禁止区域内のルートの目的地

HERE Map Contentの通行禁止制限

HERE Map Contentでは、自動車とトラックの通行禁止区域を示すために異なる用語が使用されています。

  • 自動車:through_traffic=false
  • トラック:trucks=falsedeliveries=trueの組み合わせ

実際のトラックの道路標識では、「通行禁止」または「配送専用」という用語が使用される場合があります。HERE Map Contentではこれらを区別していません。

HERE Map Contentには、自動車およびトラック以外の車両の通行禁止制限データは含まれていません。 他の車両タイプ (スクーター、オートバイ、バス) のルート検索リクエストでは、通行禁止制限データは使用可能な車両およびトラックのデータから取得されます。

HERE Map Renderingの通行禁止制限

📘

計算されたルートに存在する制限に関する最も正確な情報を取得するには、Routing APIから返されるレスポンスを必ず確認してください。

HERE Map Renderingでは、通行禁止制限はパッケージを象徴する緑色の立方体で視覚的に区別されます。 緑色のパッケージ記号が表示されている場合は、そのルートが配送専用であることを示しており、車両は荷物を積み下ろす目的でそこに進入することはできますが、エリアや近隣地域を通り抜けるための道路としては使用できません。

関連コンテンツ