Intermodal Routing API V8 に移行します

このドキュメントでは、新しいバージョン( V8 )への移行に必要な最も重要な変更について説明します。

v1 から V8 までの API バージョンが欠落しているのは、内部バージョンの整合性が原因です。

リクエスト

このセクションでは、リクエストの変更について説明します。

パラメータが追加されました

vehicle[modes], vehicle[enable]

vehicle[modes] vehicle[enable]
形式 モードの配列 ( 文字列 ) または除外されるモードの配列 ( 文字列 ) 文字列の配列
動作 モードフィルタは、どの車両モードを応答に含めるかを決定するために使用されます。 デフォルトでは、サポートされているすべての車両モードが許可されています。 プライベート車両モードが許可されている部品をルーティングします。 デフォルトでは、車両モードは許可さtransit[enable]=[]れていません () 。

の値 vehicle は、非公開 car またはです bicycle

transit[modes], transit[enable]

transit[modes] transit[enable]
形式 モードの配列 ( 文字列 ) または除外されるモードの配列 ( 文字列 ) 文字列の配列
動作 応答に含めるトランジットモードを決定するために使用されるモードフィルタ。 デフォルトでは、サポートされているすべてのトランジットモードが許可されています。 輸送モードが許可されているルート品目。 デフォルトtransit[enable]=["routeHead","routeTail","entireRoute"]では、ルート内のすべての場所でトランジットモードが許可されます()。

taxi[modes], taxi[enable]

taxi[modes] taxi[enable]
形式 モードの配列 ( 文字列 ) または除外されるモードの配列 ( 文字列 ) 文字列の配列
動作 応答に含めるタクシーモードを決定するために使用されるモードフィルタ。 デフォルトでは、サポートされているすべてのタクシーモードが許可されています。 タクシー車両モードが許可されている部品を取り回します。 デフォルトtaxi[enable]=["routeHead","routeTail","entireRoute"]では、タクシーモードはルートのどこでも使用できます () 。

rented[modes], rented[enable]

rented[modes] rented[enable]
形式 モードの配列 ( 文字列 ) または除外されるモードの配列 ( 文字列 ) 文字列の配列
動作 応答に含めるレンタルモードを決定するために使用されるモードフィルタ。 デフォルトでは、サポートされているすべてのレンタルモードが許可されています。 レンタル車両モードが許可されているルート部品。 既定rented[enable]=["routeHead","routeTail","entireRoute"]では、レンタルモードはルートのどこでも使用できます () 。

レンタル車両または車両共有サービスは、主要都市のサードパーティプロバイダによって提供されます。

pedestrian[maxDistance]|pedestrian[speed]

pedestrian[maxDistance] pedestrian[speed]
形式 整数、 0-6000 フロート、 0.5-2
動作 徒歩圏内 ( メートル ) 。 デフォルトでは、に設定 2000されています。 最長徒歩速度 ( メートル / 秒 ) 。 デフォルトでは、に設定 1されています。

パラメータが変更されました

この移行では、次のパラメータが変更されます。

基本 URL 、バージョン、リソース

パラメーター HERE v1 HERE V8
基本 URL 文字列 , https://mobility.ls.hereapi.com/v1/route 文字列 , https://intermodal.router.hereapi.com
バージョン 文字列 , /v1 文字列 , /v8
リソース 文字列 , /route 文字列 , /routes

deporigin

移行で dep は、 (v1) パラメータの名前が origin (v8) に変更されます。

dep origin
形式 文字列 , {lat},{lng}[,{name}] 文字列 , {lat},{lng}[;name={name}]
動作 WGS-84 準拠の出発座標を設定します。 WGS-84 準拠の原点座標を設定します。

arrdestination

移行で arr は、 (v1) パラメータの名前が destination (v8) に変更されます。

arr destination
形式 文字列 , {lat},{lng}[,{name}] 文字列 , {lat},{lng}[;name={name}]
動作 WGS-84 準拠の到着座標を設定します。 WGS-84 に準拠した目的地の座標を設定します。

timedepartureTime/arrivalTime

この移行で time は、 (v1) パラメータの名前が departureTime (v8) に変更されます。

time departureTime
形式 日時 ,
YYYY-mm-ddTHH:MM:SS(.NNN)(Z|+/-AA:BB)
日時 ,
YYYY-mm-ddTHH:MM:SS(.NNN)(Z|+/-AA:BB)
動作 出発 / 到着時間を指定します (ISO 8601) 。 オプションの timezone オフセットが指定されていない場合、時間はローカルと見なされます。 出発時間を設定します。 RFC 3339 、セクション 5.6 を参照してください。

intermodal_maxalternatives

この移行で intermodal_max は、 (v1) パラメータの名前が alternatives (v8) に変更されます。

intermodal_max alternatives
形式 整数、 1-6 整数、 0-5
動作 応答で返されるパークおよびライドルートの最大数を設定します。 デフォルトでは、に設定 3されています。 より大きい値 6 はクリップされます 6 最適なルートから離れて戻る代替ルートの数を設定します。 デフォルトでは、に設定 0されています。

car_change_strategystrategy

この移行で car_change_strategy は、 (v1) パラメータの名前が strategy (v8) に変更されます。 via=strategy={strategy} これは、パラメータ( V8 )を使用して設定されます。

car_change_strategy strategy
形式 文字列 , snake_case 文字列 , camelCase
動作 パークルートとライドルートを検索するための戦略を設定します。 デフォルトでは、に設定 diverse_choicesされています。 パークルートとライドルートを検索するための戦略を設定します。 デフォルトでは、に設定 diverseChoicesされています。

parking_lot_name, parking_lot_coordsplace:parkingLot

この移行で parking_lot_name, parking_lot_coords は、 (v1) パラメータの名前が place:parkingLot (v8) に変更されます。 via=place:parkingLot これは、( V8 )パラメータを使用して設定されます。

parking_lot_name, parking_lot_coords place:parkingLot
形式 文字列 , name, {lat},{lng} 文字列 , place:parkingLot
動作 駐車場の名前と地理座標を設定します。 加工方式の値がでない限り、無視 single_lotされます。 相互に排他的なパラメーター。 パークルートとライドルートを検索するための戦略を設定します。 デフォルトでは、に設定 diverseChoicesされています。

details, graph, maneuversreturn=intermediate,polyline,actions

この移行で details, graph, maneuvers は、 (v1) パラメータの名前が intermediate, polyline, actions (v8) に変更されます。 これらの値は return 、( V8 )パラメータを使用して設定できます。 デフォルトでは、すべてのオプションが無効になっています。

details, graph, maneuvers return=intermediate,polyline,actions
形式 ブール型、 1/0 文字列の配列 , intermediate,polyline,...
動作 応答オプションを有効または無効にします。 デフォルトで details は、のみが有効になっています。 すべてのオプションがデフォルトで無効になっています。

sections 次の属性が応答でパラメーターに追加されました。

  • travelSummary: セクションの移動部分の概要を有効にします。
  • fares: ルートの一部をカバーする運賃 / チケットのリスト。

パラメータが削除されました

この移行では、次のパラメータが削除されます。

形式

この移行では、 Format パラメータ( v1 )が削除されます。 応答は常に JSON 形式( V8 )で返されます。

arrival

arrivaldepartureTime/arrivalTime この移行では、パラメータを個別に設定できるようになったため、パラメータ( v1 )が削除されます( V8 )。

strict

この移行で strict は、パラメータ( v1 )が削除されます。 デフォルトで 0 は、( V8 )に設定されています。

routingMode

この移行で routingMode は、パラメータ( v1 )が削除されます。 デフォルトで realtime は、( V8 )に設定されています。

レスポンス

ここでは、応答の変更点について説明します。

パラメータが追加されました

この移行では、次のパラメータが応答として導入されます( V8 )。

パラメータが変更されました

この移行では、応答のパラメータに次の変更が加えられました( V8 )。

  • Connection パラメータの名前を (v1) から routes (v8) に変更します
  • Sec パラメータの名前を (v1) から sections (v8) に変更します
  • Dep および Arrdeparturearrival v8 )に名前とパラメータを変更します( v1 )。
  • Stn パラメータの名前を (v1) から place (v8) に変更します
  • distance パラメータの名前を (v1) から length (v8) に変更します
  • 整数 mode パラメータ( v1 )を文字列( V8 )に変更します
  • および xy パラメータ( v1 )の名前を lng、および lat ( V8 )に変更します。
  • graph パラメータ( v1 )の名前を polyline ( V8 )に変更し、その形式を Flexible ポリラインに変更します

パラメータが削除されました

この移行では、 (V8) 応答の次のパラメータが削除されます。

  • Res
  • valid_until
  • context
  • serviceUrl
  • mode: From sections パラメータ( v1 )
  • transfers
  • duration: From sections パラメータ( v1 )
  • Guidance
  • Freq: Dep のパラメーター( v1 )から sections
  • Journey
  • Tariff
  • Transport
  • Operators

コード

次の表に、この移行で変更された応答コードを示します。

V1 エラーコード V8 エラーコード ステータスコード 説明
GW100 E602000 400 リクエストが正しくありません パラメータタイプが正しくないか、またはパラメータがありません
I4 該当なし 401 Unauthorized for Wrong 資格情報、 403 Forbidden for access not allowed. 該当なし
GW0001 該当なし 200 OK です 空のルートリストと通知オブジェクトを返します
GW0002 E602100、、 E602101 E602102 504 ゲートウェイタイムアウト、 503 サービス利用不可、 502 不正なゲートウェイ バックエンドが応答を提供できませんでした
GW0006 E602103 500 台の内部サーバーエラーです 予期しないエラーが発生し
GW0007 該当なし 200 OK です この地域では、この API はサポートされていません
K9360 E602104 400 リクエストが正しくありません 期間が無効です

Intermodal Routing API v1 の例では、 HERE API キー を使用して要求を認証します。 HERE Token Credentials 認証は、 Intermodal Routing API V8 でのみ可能です。 その他のオプションについては 、『 Identity & Access Management Guide』を参照してください。

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

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