公共交通機関の Next Departures V8 に移行します

このドキュメントでは、新しいバージョン( V8 )への移行に必要な最も重要な変更について説明します。 公共交通機関の Next Departures v3 では、次の出発地点を検索できます。

  • multiboard/by_stn_ids+ stnIds パラメータを使用したステーション ID
  • multiboard/by_geocoord+center パラメータを使用してステーションの地理座標を指定します

公共交通機関の Next Departures V8 は、リクエストパラメータによってクエリーを区別 ids し、 in次のことを行います。

  • multiboard/by_stn_ids.json?stnIds (v3) は departures?ids (v8) に置き換えられます
  • multiboard/by_geocoord.json?center (v3) は departures?in (v8) に置き換えられます

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

リクエスト

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

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

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

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

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

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

パラメーター 公共交通機関の次の出発便 v3 公共交通機関の Next Departures V8
基本 URL 文字列 , https://transit.ls.hereapi.com 文字列 , https://transit.hereapi.com
バージョン 文字列 , /v3 文字列 , /v8
リソース 文字列 /multiboard/<name> 文字列 , /departures

stnIdsids

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

stnIds ids
形式 文字列 文字列
動作 ステーション ID のカンマ区切りリストを指定します。 ステーション ID のカンマ区切りリストを指定します。 1 つのクエリーでは、最大 50 のステーション ID を使用できます。

centerin

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

center in
形式 ダブル、ダブル 文字列
動作 検索の中心点の緯度と経度をコンマで区切って指定します。 検索の中心点と任意の半径を指定します。 形式 {lat},{lng}[;r={radius}]。デフォルトはradius=500 メートルです。

timetime

この移行 time では、必須パラメータ( v3 )がオプション( V8 )に変更されます。 time が指定されていない場合、出発地点の現在の時刻が使用されます。 応答のすべての時間値が、各場所のタイムゾーンで返されます。

maxmaxPerBoard

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

max maxPerBoard
形式 整数 整数
動作 デフォルトでは、に設定 50されています。 最小値はで 1 、最大値はです 100 デフォルトでは、に設定 5されています。 最小値はで 1 、最大値はです 50

maxStnmaxPlaces

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

maxStn maxPlaces
形式 整数 整数
動作 デフォルトでは、に設定 50されています。 最小値はで 1 、最大値はです 50 デフォルトでは、に設定 5されています。 最小値はで 1 、最大値はです 50

この変更は、次の出発地点が駅の地理座標で検索された場合にのみ有効です。

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

この移行では、パラメータは削除されません。

レスポンス

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

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

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

  • notices: を呼び出してオブジェクトに応答します
  • type: place タイプ
  • agency: Operators パラメーター( v3 )に似ています
  • waypoint
  • status: 出発のステータス
  • delay: イベントの予定時刻からの累積遅延(秒)
  • platform: 出発のプラットフォーム名または番号
  • location、 : originalLocation オブジェクト xy 内に前者および後者のパラメーター( v3 )が含まれています Stn
  • transport: Transport In Dep パラメータ( v3 )と似ています。 詳細については 、「トランスポートの概念」を参照してください

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

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

  • MultiNextDeparture パラメータの名前を (v3) から boards (v8) に変更します
  • Stn および Dep のパラメータ( v3 )の名前を place および departures ( V8 )に変更します
  • 整数 mode パラメータ( v3 )を文字列( V8 )に変更します
  • xy およびの各パラメータの名前を lng、および lat ( v8 )に変更します。
  • Attributions パラメータの名前を (v3) から attributions (v8) に変更します

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

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

  • Res
  • serviceUrl
  • MultiNextDepartures
  • NextDepartures
  • Operators
  • journey_ctx
  • duration
  • distance

コード

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

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 Next Departures v3 の例では、 HERE API キー を使用してリクエストを認証します。 HERE Token Credentials 認証は、公共交通機関の Next Departures V8 でのみ可能です。 その他の認証オプションについては 、『 Identity & Access Management Guide』を参照してください。

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

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