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 |
dep
対 origin
移行で dep
は、 (v1) パラメータの名前が origin
(v8) に変更されます。
| dep | origin |
形式 | 文字列 , {lat},{lng}[,{name}] | 文字列 , {lat},{lng}[;name={name}] |
動作 | WGS-84 準拠の出発座標を設定します。 | WGS-84 準拠の原点座標を設定します。 |
arr
対 destination
移行で arr
は、 (v1) パラメータの名前が destination
(v8) に変更されます。
| arr | destination |
形式 | 文字列 , {lat},{lng}[,{name}] | 文字列 , {lat},{lng}[;name={name}] |
動作 | WGS-84 準拠の到着座標を設定します。 | WGS-84 に準拠した目的地の座標を設定します。 |
time
対 departureTime/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_max
対 alternatives
この移行で intermodal_max
は、 (v1) パラメータの名前が alternatives
(v8) に変更されます。
| intermodal_max | alternatives |
形式 | 整数、 1-6 | 整数、 0-5 |
動作 | 応答で返されるパークおよびライドルートの最大数を設定します。 デフォルトでは、に設定 3 されています。 より大きい値 6 はクリップされます 6 。 | 最適なルートから離れて戻る代替ルートの数を設定します。 デフォルトでは、に設定 0 されています。 |
car_change_strategy
対 strategy
この移行で 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_coords
対 place: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, 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
arrival
departureTime/arrivalTime
この移行では、パラメータを個別に設定できるようになったため、パラメータ( v1 )が削除されます( V8 )。
strict
この移行で strict
は、パラメータ( v1 )が削除されます。 デフォルトで 0
は、( V8 )に設定されています。
routingMode
この移行で routingMode
は、パラメータ( v1 )が削除されます。 デフォルトで realtime
は、( V8 )に設定されています。
レスポンス
ここでは、応答の変更点について説明します。
パラメータが追加されました
この移行では、次のパラメータが応答として導入されます( V8 )。
-
notices
: を呼び出して、オブジェクト、および routes
sections
パラメーターを応答します -
spans
: 詳細については 、『 Routing API V8 開発者ガイド』を参照してください -
type
: mode
パラメーターに類似( v1 ) -
preActions, actions, postActions
: Guidance
パラメータ( v1 )に類似しています。 詳細については 、「アクションの概念」を参照してください intermediateStops
-
fares
: Tariff
パラメーターに類似( v1 ) -
travelSummary
: Journey
パラメーターに類似( v1 ) -
agency, attributions
: Operators
パラメーターに類似( v1 ) -
transport
: Transport
Dep
の In パラメータ( v1 )に類似 sections
しています。 詳細については 、「トランスポートの概念」を参照してください
パラメータが変更されました
この移行では、応答のパラメータに次の変更が加えられました( V8 )。
Connection
パラメータの名前を (v1) から routes
(v8) に変更します Sec
パラメータの名前を (v1) から sections
(v8) に変更します Dep
および Arr
( departure
arrival
v8 )に名前とパラメータを変更します( v1 )。 Stn
パラメータの名前を (v1) から place
(v8) に変更します distance
パラメータの名前を (v1) から length
(v8) に変更します - 整数
mode
パラメータ( v1 )を文字列( V8 )に変更します - および
x
y
パラメータ( 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』を参照してください。