hi, hikaru

『駅すぱあと』でお馴染みヴァル研究所で、テクニカルエバンジェリストとして働いている丸山が綴るブログです。

エクスプレス予約の料金が利用できるように! #駅すぱあとWebサービス

こんにちは。 駅すぱあとWebサービスの経路探索APIで、エクスプレス予約の料金が取得できるようになりました。

f:id:hiiiiiiihikaru:20171213134324p:plain

駅すぱあとWebサービスとは

国内初の乗換案内ソフト駅すぱあとがもつ様々な情報をWebAPIで提供しているサービスです。

ekiworld.net

経路探索はもちろん、駅データや時刻表などの情報を取得できます。 無料で使えるフリープランを用意しており、企業にかぎらず個人でも利用できます。

最近 facebookページ を立ち上げて、駅すぱあとWebサービスの最新情報をお知らせしています。 このページが良いと思ったらいいね!を押してもらえると嬉しいです。よろしくお願いします!

駅すぱあとWebサービスエクスプレス予約の料金が取得可能に

エクスプレス予約」とは、JR東海JR西日本が提供する、会員制のネット予約サービスです。

みなさん使ってますか?私は今年から年会費無料のスマートEXを使い始めて(遅)、その便利さにびっくりしました!! その感動を周りのみんなに伝えたら、「もう使ってるし〜」の嵐でさらにびっくり!(笑) 出張が多いビジネスマンはもはや必須のサービスですよね。

はい、前置きが長くなりましたが・・この度、駅すぱあとWebサービスでそのエクスプレス予約の料金計算に対応しました。

f:id:hiiiiiiihikaru:20180419143213g:plain

HTML5インターフェースサンプル デモページより

探索条件生成APIに、エクスプレス予約の料金を反映させるためのJRReservationパラメータが追加されたのと、 経路探索APIのレスポンスに、エクスプレス予約の料金情報が付与されます。

エクスプレス予約の料金取得方法

エクスプレス予約の料金を取得するには、どのような内容のAPIリクエストを送ればよいのかを解説します。 HTML5インターフェースサンプルを利用して実装するのであれば読み飛ばしてもらって構いません。

1. 経路探索に用いる条件を生成する

エクスプレス予約の料金を経路探索結果に反映させるには、探索条件生成で探索条件を生成する必要があります。JRReservationパラメータの値に、適用したい割引を指定します。

curl "https://api.ekispert.jp/v1/xml/toolbox/course/condition?key=xxx&JRReservation=smartEx"
<ResultSet apiVersion="1.27.0.0" engineVersion="201804_02a">
<Condition>T3221233232319:F332112212001:A23121141:</Condition>
</ResultSet>

2. 経路探索を行う

1で生成した詳細探索条件を用いて経路探索 /search/course/extremeを行います。ダイヤによる探索平均待ち時間による探索は問いません。リクエスト例では、平均待ち時間による探索を行なっています。

curl "https://api.ekispert.jp/v1/xml/search/course/extreme?key=xxx&searchType=plain&viaList=東京:なんば&conditionDetail=T3221233232319:F332112212001:A23121141:"
:
<Price fareRevisionStatus="none" toLineIndex="1" fromLineIndex="1" kind="Fare" index="1" selected="true">
<Type>Fare</Type>
<Oneway remark="スマートEX" fullRemark="スマートEX" includedInCharge="true">0</Oneway>
<RevisionStatus>latest</RevisionStatus>
<Round remark="スマートEX" fullRemark="スマートEX" includedInCharge="true">0</Round>
</Price>
:

経路簡易探索 /search/course平均待ち時間探索 /search/course/plainではエクスプレス予約の料金計算に対応しておりません。

※指定された割引と適用される割引が一致しないケースがあります。詳しくはドキュメントのエクスプレス予約項目をご確認ください。

HTML5インターフェースサンプルでの実装例

弊社が提供しているHTML5インターフェースサンプルでは、エクスプレス予約に対応しました。

※最新のバージョンをご利用ください。

github.com

探索条件パーツ(expGuiCondition)と経路表示パーツ(expGuiCourse)を使えば、簡単に実装することができます。 実装例はデモページソースコードをご覧ください。

終わりに

駅すぱあとWebサービスエクスプレス予約の料金計算に対応したよ、というお話でした。 このブログ読んでたら使ってみたくなった、という方、こちらからweb上でお申し込みができますので、お気軽に触ってみてください。 ではでは。