公共交通機関ルーティング V8 に移行します

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

API のバージョンが v3 から V8 に欠落しているのは、内部バージョンのアライメントが原因です。

リクエスト

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

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

この移行では、新しいパラメータは導入されません。

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

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

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

パラメーター 公共交通機関ルーティング v3 公共交通機関ルーティング V8
基本 URL 文字列 , https://transit.ls.hereapi.com 文字列 , https://transit.router.hereapi.com
バージョン 文字列 , /v3 文字列 , /v8
リソース 文字列 /route 文字列 , /routes

deporigin

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

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

arrdestination

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

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

timedepartureTime/arrivalTime

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

time departureTime/arrivalTime
形式 日時 ,
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 を参照してください。

maxalternatives

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

max alternatives
形式 整数、 1-6 整数 0-5
動作 応答で返されるルートの最大数を設定します。 デフォルトでは、に設定 3されています。 最適なルートから離れて戻る代替ルートの数を設定します。 デフォルトでは、に設定 0されています。

walkpedestrian[maxDistance], pedestrian[speed]

walk pedestrian[maxDistance], pedestrian[speed]
形式 整数 0-6000。整数 50-200 整数 0-6000、浮動小数点数 0.5-2
動作 最長徒歩距離 ( メートル ) および速度 ( メートル / 秒 ) 。 デフォルトでは、に設定 2000,100されています。 最長徒歩距離 ( メートル ) および速度 ( メートル / 秒 ) 。 デフォルトでは、に設定 2000,1されています。

details, graph, maneuversreturn=intermediate,polyline,actions

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

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

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

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

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

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

形式

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

arrival

この移行では、departureTime/arrivalTime パラメータを個別に設定できるため( V8 )、arrivalパラメータ( v3 )が削除されます。

strict

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

routingMode

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

レスポンス

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

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

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

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

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

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

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

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

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

コード

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

V3 エラーコード 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 リクエストが正しくありません 期間が無効です

Public Transit Routing v3 の例では、 HERE API キー を使用して要求を認証します。 HERE Token Credentials 認証は、公共交通機関ルーティング V8 でのみ可能です。 その他の認証オプションについては 、『 Identity & Access Management Guide』を参照してください。

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

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