公共交通機関ルーティング V8 に移行します
このドキュメントでは、新しいバージョン( V8 )への移行に必要な最も重要な変更について説明します。
注
API のバージョンが v3 から V8 に欠落しているのは、内部バージョンのアライメントが原因です。
リクエスト
このセクションでは、リクエストの変更について説明します。
パラメータが追加されました
この移行では、新しいパラメータは導入されません。
パラメータが変更されました
この移行では、次のパラメータが変更されます。
基本 URL 、バージョン、リソース
パラメーター | 公共交通機関ルーティング v3 | 公共交通機関ルーティング V8 |
基本 URL | 文字列 , https://transit.ls.hereapi.com | 文字列 , https://transit.router.hereapi.com |
バージョン | 文字列 , /v3 | 文字列 , /v8 |
リソース | 文字列 /route | 文字列 , /routes |
dep
対 origin
この移行では、 dep
パラメーター( v3 )の名前がorigin
( v8 )に変更されます。
| dep | origin |
形式 | 文字列 , {lat},{lng}[,{name}] | 文字列 , {lat},{lng}[;name={name}] |
動作 | WGS-84 準拠の出発座標を設定します。 | WGS-84 準拠の原点座標を設定します。 |
arr
対 destination
この移行では、 arr
パラメーター( v3 )の名前がdestination
( v8 )に変更されます。
| arr | destination |
形式 | 文字列 , {lat},{lng}[,{name}] | 文字列 , {lat},{lng}[;name={name}] |
動作 | WGS-84 準拠の到着座標を設定します。 | WGS-84 に準拠した目的地の座標を設定します。 |
time
対 departureTime/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 を参照してください。 |
max
対 alternatives
この移行では、 max
パラメーター( v3 )の名前がalternatives
( v8 )に変更されます。
| max | alternatives |
形式 | 整数、 1-6 | 整数 0-5 |
動作 | 応答で返されるルートの最大数を設定します。 デフォルトでは、に設定 3 されています。 | 最適なルートから離れて戻る代替ルートの数を設定します。 デフォルトでは、に設定 0 されています。 |
walk
対 pedestrian[maxDistance], pedestrian[speed]
| walk | pedestrian[maxDistance], pedestrian[speed] |
形式 | 整数 0-6000 。整数 50-200 | 整数 0-6000 、浮動小数点数 0.5-2 |
動作 | 最長徒歩距離 ( メートル ) および速度 ( メートル / 秒 ) 。 デフォルトでは、に設定 2000,100 されています。 | 最長徒歩距離 ( メートル ) および速度 ( メートル / 秒 ) 。 デフォルトでは、に設定 2000,1 されています。 |
この移行では、 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) 応答に次のパラメータが導入されました。
-
notices
: を呼び出して、オブジェクト、および routes
sections
パラメーターを応答します -
spans
: 詳細については 、『 Routing API V8 開発者ガイド』を参照してください -
type
: mode
パラメーター( v3 )に似ています -
preActions
、 actions
、: postActions
Guidance
パラメーター( v3 )に似ています。 詳細については 、「アクションの概念」を参照してください intermediateStops
-
fares
: Tariff
パラメーター( v3 )に似ています -
travelSummary
: Journey
パラメーター( v3 )に似ています -
agency
: Operators
パラメーター( v3 )に似ています attributions
-
transport
: sections
の Transport
In Dep
パラメータ( v3 )に類似しています。 詳細については 、「トランスポートの概念」を参照してください
パラメータが変更されました
この移行では、応答のパラメータに次の変更が加えられました( 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 )に変更します x
、 y
およびの各パラメータの名前を 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 リクエストが正しくありません | 期間が無効です |