バイクの配達状況を計算してルートを確認します

ニューヨークシティのウエストサイドアベニュー / ユニオンストリートからマンハッタンモールまでのモーダルルートをリクエストします 。このルートには、レンタルタイプと交通タイプbicycletransit、いわゆるバイクシェア、乗り物のインターモーダルルートを組み合わせて使用します。

リクエスト

認証

モーダル間ルーティングでは、 API キー と Bearer トークンの両方を使用した認証がサポートされます。 はじめにを無料で利用 するには、フリーミアム HERE Developer アカウントを作成して API キー を取得します。 その他の認証方法について は、『 Identity & Access Management 開発者ガイド』を参照してください。

バイクの共有と配車ルートリクエストを作成します

GET https://intermodal.router.hereapi.com/v8/routes
    ?origin=40.718211,-74.083639
    &destination=40.74912,-73.98827
    &rented[modes]=bicycle
    &rented[enable]=routeHead
    &transit[enable]=routeTail
    &taxi[enable]=
    &alternatives=2
    &apiKey=

モーダル間ルートリクエストの一般的な必須パラメータは origin 、 AND のみ destination<latitude>,<longitude> で、形式で提供されます。 特にバイクの共有と乗り心地のリクエスト rented[modes]=bicyclerented[enable]=routeHeadtransit[enable]=routeTailtaxi[enable]= の場合は、パラメーター、、、を設定し、レスポンスにバイクの共有と乗継ぎのモーダル間ルートを指定するようにします。

rented[modes]=bicycleおよび rented[enable]=routeHead のパラメータは、ルート の head セクションにある共有bikeルートオプションを戻すように、モーダル間ルータに指示 します。一方、このtransit[enable]=routeTailパラメータは、ルートの末尾セクションにあるパブリックトランジットルートオプションを戻すようにモーダル間ルータに指示します。 taxi[enable]=taxi このパラメータは、応答の転送タイプを無効にするために必要です。デフォルトでは有効になっています。

デフォルトでは、 Intermodal Routing API V8 は最適なルートのみを返します。 オプションのパラメータ alternatives は、最適なルートを除いて戻る代替ルートの数を表します。 デフォルトでは、に設定 alternatives=0されています。

応答

成功した応答には、計算されたルートに関する次の詳細情報が含まれています。

• 1 つの最適なルートがセクションに分割されます
• 各セクションの出発時間と到着時間、所要時間、座標、およびその他のセクションごとの情報
• セクションごとに、次のいずれかのトランスポートタイプがあります。
  • rented - 出発地から乗り継ぎ地点までのルートセクション
  • pedestrian rented - バイクスタンドから transit 駅まで徒歩で行けるルートセクション
  • transit - 公共交通機関の出発および到着ステーションがあるルートセクション
    • 任意 return=intermediate で、 request パラメーターを設定することで、すべての中間の分岐点を返すことができます。
• オペレータコード、オペレータ名、オペレータの Web サイトへのリンクなど、サービスを実行するオペレータのセット

{
    "routes": [
        {
            "id": "R0040e5-C0",
            "sections": [
                {
                    "id": "R0040e5-C0-S0",
                    "type": "rented",
                    "departure": {
                        "time": "2021-01-27T10:02:00-05:00",
                        "place": {
                            "type": "place",
                            "location": {
                                "lat": 40.718211,
                                "lng": -74.083639
                            }
                        }
                    },
                    "arrival": {
                        "time": "2021-01-27T10:14:00-05:00",
                        "place": {
                            "type": "place",
                            "location": {
                                "lat": 40.73367,
                                "lng": -74.0625
                            }
                        }
                    },
                    "transport": {
                        "mode": "bicycle"
                    }
                },

                ...
                ... walk section from bike stand to station access point
                ...

                {
                    "id": "R0040e5-C0-S2",
                    "type": "transit",
                    "departure": {
                        "time": "2021-01-27T10:19:00-05:00",
                        "place": {
                            "name": "Journal Square",
                            "type": "station",
                            "location": {
                                "lat": 40.73301,
                                "lng": -74.06289
                            }
                        }
                    },
                    "arrival": {
                        "time": "2021-01-27T10:42:00-05:00",
                        "place": {
                            "name": "33rd Street",
                            "type": "station",
                            "location": {
                                "lat": 40.74912,
                                "lng": -73.98827
                            }
                        }
                    },
                    "transport": {
                        "mode": "regionalTrain",
                        "name": "PATH",
                        "category": "Rail",
                        "color": "#ff9900",
                        "textColor": "#000000",
                        "headsign": "33rd Street"
                    },
                    "agency": {
                        "id": "3XQ15100",
                        "name": "Port Authority Trans-Hudson Corporation",
                        "website": "http://www.panynj.gov/path/"
                    }
                }
            ]
        },

        ...
        ... additional routes as requested per the alternatives parameter
    ]
}