公共交通機関の検索 V8 に移行します

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

  • stations/by_ids+ stnIds パラメータを使用したステーション ID
  • stations/by_geocoord+center パラメータを使用してステーションの地理座標を指定します
  • stations/by_name+name およびcenterパラメータを含むステーション名 ( およびジオ座標 )

Public Transit Station Search V8 は、リクエストパラメータ idsin、、および nameによってクエリーを区別します。

  • stations/by_ids.json?stnIds (v3) は stations?ids (v8) に置き換えられます
  • stations/by_geocoord.json?center (v3) は stations?in (v8) に置き換えられます
  • stations/by_name.json?name=&center= (v3) は stations?name=&in= (v8) に置き換えられます

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

リクエスト

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

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

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

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

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

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

パラメーター 公共交通機関ステーションの検索 v3. 公共交通機関の検索 V8
基本 URL 文字列 , https://transit.ls.hereapi.com 文字列 , https://transit.hereapi.com
バージョン 文字列 , /v3 文字列 , /v8
リソース 文字列 /stations/<name> 文字列 , /stations

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 メートルです。

detailsreturn=transport

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

details return=transport
形式 整数 文字列
動作 すべてのステーションの回線情報を有効または無効にします。 デフォルト 1 では、(有効)に設定されています。 応答で転送情報をイネーブルにします。 デフォルトでは無効になっています。

maxmaxPlaces

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

max maxPlaces
形式 整数 整数
動作 該当なし 該当なし

この変更は、ステーション名または地理座標、あるいはその両方でステーションが照会された場合にのみ有効です。 デフォルトでは、に設定 5されています。 最小値はで 1 、最大値は 25 ( 名前でクエリ ) または 50 ( ジオ座標でクエリ ) です。

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

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

all

この移行で all は、すべてのクエリメソッドのパラメータ (v3) が削除されます。

レスポンス

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

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

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

  • notices: および stations オブジェクトに応答します
  • type: place タイプ
  • waypoint
  • elv: location パラメーター( V8 )
  • location、 : originalLocation オブジェクト xy 内に前者および後者のパラメーター( v3 )が含まれています Stn
  • platform: 出発のプラットフォーム名または番号
  • transport: 詳細については 、「トランスポートの概念」を参照してください

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

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

  • Stations パラメータの名前を (v3) から stations (v8) に変更します
  • Stn パラメータの名前を (v3) から place (v8) に変更します
  • xy およびの各パラメータの名前を lng、および lat ( v8 )に変更します。
  • の名前を country に変更 countryName します (v8)
  • の名前を ccode に変更 countryCode します (v8)
  • の名前を number に変更 houseNumber します (v8)

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

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

  • Res
  • serviceUrl
  • has_board
  • district

コード

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

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

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

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

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