トランジットルートの形状を取得します

ユーザーストーリー

ローマフィウミチーノ国際空港のターミナル 1 からローマテルミニ中央駅までの公共交通機関を利用したトランジットルートをリクエストする場合。 ルートのシェイプも取得する必要があります。

リクエスト

ルートの形状を取得するには、ルートリクエストの必須originパラメータおよびdestination パラメータの後に return=polylineを指定します。 これにより、各セクションにポリラインフィールドが作成されます。 このポリラインは 、 Flexible ポリラインを使用してエンコードされます。 このポリラインは 、 Flexible ポリライン レポジトリで利用できる例を使用して、多くの主要言語で簡単にデコードできます。

デコードされたポリラインは、ルートのレンダリングに使用できる一連の座標になり ます(たとえば、 JavaScript for Maps API を使用)。

次のリクエストは、形状情報を使用してトランジットルートを計算します。

GET https://transit.router.hereapi.com/v8/routes
    ?origin=41.79457,12.25473
    &destination=41.90096,12.50243
    &return=polyline
Authorization: Bearer 

現在使用可能な認証方法の詳細について は、『 Identity & Access Management 開発者ガイド』を参照してください。

オプションのパラメータ alternatives は、最適なルートを除いて戻る代替ルートの数を表します。 デフォルトで alternatives=0は、設定されていない場合、最適なルートが 1 つだけ返されます。

レスポンス

ルートの計算が成功した場合 /routes 、応答には計算されたルートについて要求された詳細情報が含まれます。

  • alternatives が 0 より大きい場合を除き、最適な 1 つの配送ルート
  • 複数の輸送セクションがあり、各セグメント(歩行者または輸送セグメントを表す)には、出発 / 到着時間、所要時間、および座標が含まれています
  • 輸送セグメントには、実際の配達地点または出発地と到着地が表示されます。 必要に応じて、中間のすべての中継地点もパラメータを使用して要求できます return=intermediate
  • 代替品に含まれているサービスを実行するオペレータのセット。オペレータコード、オペレータ名、オペレータの Web サイトへのリンク ( 存在する場合 ) などが含まれます
  • polylineFlexible ポリラインを使用してエンコードされた、フィールド内のルートの形状
{
  "routes": [
    {
      "id": "R00132f-C0",
      "sections": [
        {
          "id": "R00132f-C0-S0",
          "type": "pedestrian",
          "polyline": "BHkrsl9Y6503pHq9Gr1O9uB9uBhjCjmEAz1BjUp8B_1Kr2T5hKw0JruFxoKk6Dl-D",
          "departure": {
            "time": "2020-04-22T12:17:00+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 41.79457,
                "lng": 12.25473
              }
            }
          },
          "arrival": {
            "time": "2020-04-22T12:23:00+02:00",
            "place": {
              "name": "Fiumicino Aeroporto",
              "type": "station",
              "location": {
                "lat": 41.793466,
                "lng": 12.251997
              },
              "id": "415713377"
            }
          }
        },
        {
          "id": "R00132f-C0-S1",
          "type": "transit",
          "polyline": "BHsq1k9Yow_1pHr9sEk8sEzjGooJ7wFw9J_mE0iJngDg1Hn9Bw_IvC8jJkcg1H08BkkHgj9Bkh3E0rhDkriHoi6Nkl9egmqB4g3D4qJ49vBz9D0isB3-d89qI8gIwr_Bw2oB87_Ds9oB41oEgvUoyoD0xJ4rjE7jEgqjBrhiBs8jF4Swqa8sHghlBkm4BwngF8x-B4m3Ekq7BsixCgw0B8rmC4gTolrB8oE04rBngIgo8E_qHsqwD44CktyBs4KoppB0mgBg7sBgggF8vnD88sBoyY0k3F41kB88Y0mMgzSstXs4tB8jgCsorB40YkhpB7zBos-BnppBwlQrpF08V0rC8zV8kLo-NgsTolIw-a4hGwrkCoGgkDoGo4BA4rBoGo4Bg9D464B4SoyJAo4B4rBgxTo4B45YojEol9CoG4vEnG4vEvMwienGgvFv3CowU_xBolSn4BolS_nG4qsBnrKohhCn8E4zgB_6Oo8oDAo1FAoxCAg9DvMw2UwM4zyCnGw3CoG4mQ4rBw9TwwDw9TofwiFg-KgyaozQgxToqc41Vg9D4rBg7OwuOg-K40Ow3Cw7FwiFg-KghHo8doxCwpd4kCw9sBoqDw_hBgvFwzY4rBwwD4So4BofwiFgvFo9L4kbgmqB4yZw1mBsvHs9K03asuUoyd0oLk0J3D8mK7nCoiHvjCs9ZzkNwhcrtSsyDnzGw5QnrjBw3C_uFwla3uvBgZ3rBomZ3gxB4kCvpE4_Q36fgyB39C4kC_8Dkmaz10Bwlfn75Boh6Cz-zD48Pjha",
          "departure": {
            "time": "2020-04-22T12:23:00+02:00",
            "place": {
              "name": "Fiumicino Aeroporto",
              "type": "station",
              "location": {
                "lat": 41.793466,
                "lng": 12.251997
              },
              "id": "415713377"
            }
          },
          "arrival": {
            "time": "2020-04-22T12:55:00+02:00",
            "place": {
              "name": "Roma Termini",
              "type": "station",
              "location": {
                "lat": 41.90054,
                "lng": 12.502168
              },
              "id": "415712984"
            }
          },
          "transport": {
            "mode": "regionalTrain",
            "name": "LE",
            "category": "Regional Train",
            "color": "#4C8DC1",
            "textColor": "#000000",
            "headsign": "Roma Termini"
          },
          "agency": {
            "id": "aDmtre00",
            "name": "Trenitalia",
            "website": "http://www.trenitalia.com/"
          },
          "attributions": [
            {
              "id": "R00132f-C0-S1-link-0",
              "href": "http://creativecommons.org/licenses/by/3.0/it/",
              "text": "Some line names used in this product or service were edited to align with official transportation maps.",
              "type": "disclaimer"
            }
          ]
        },
        {
          "id": "R00132f-C0-S2",
          "type": "pedestrian",
          "polyline": "BHyvnm_YgztuuHw8GsqH",
          "departure": {
            "time": "2020-04-22T12:55:00+02:00",
            "place": {
              "name": "Roma Termini",
              "type": "station",
              "location": {
                "lat": 41.90054,
                "lng": 12.502168
              },
              "id": "415712984"
            }
          },
          "arrival": {
            "time": "2020-04-22T12:56:00+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 41.90096,
                "lng": 12.50243
              }
            }
          }
        }
      ]
    }
  ]
}

」に一致する結果は 件です

    」に一致する結果はありません