hi, hikaru

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

中学の通学定期券料金に対応しました! #駅すぱあとWebサービス

こんにちは。 駅すぱあとWebサービスで、中学の通学定期券の定期代が取得できるようになりました!

f:id:hiiiiiiihikaru:20171213134324p:plain

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

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

ekiworld.net

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

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

中学の通学定期券料金に対応

電車で通勤、通学をする際に、多くの人が「定期券」を購入しますよね。

駅すぱあとWebサービスでは、「通勤定期券」はもちろんのこと、学生のみが利用可能な「通学定期券」の定期代が取得できます。

通学定期券は「大学」「高校」を対応しておりましたが、このたび新たに「中学」が追加されました。

f:id:hiiiiiiihikaru:20180521135245p:plain

通学定期券(中学)の定期代の取得方法

通学定期券の定期代を取得するには、まず探索条件生成APIで探索条件を作ります。teikiKindパラメータにjuniorHighSchoolという値をセットすると、中学の通学定期券の料金を取得する設定となります。

$ curl "https://api.ekispert.jp/v1/xml/toolbox/course/condition?key=xxx&teikiKind=juniorHighSchool"
<ResultSet apiVersion="1.27.0.0" engineVersion="201805_03a">
<Condition>T3221233232319:F342112212000:A23121141:</Condition>
</ResultSet>

探索条件生成API /toolbox/course/conditionのレスポンスで得たResultSet/Conditionの値を、経路探索APIのconditionDetailパラメータにセットします。リクエスト例ではsearchTypeパラメータにplainをセットしていますが、その他の値(departurearrivalなど)でも定期代を取得できます。

$ curl "https://api.ekispert.jp/v1/xml/search/course/extreme?key=wC4SR9ETBhBcJ3Bv&viaList=三鷹:新宿:渋谷&searchType=plain&conditionDetail=T3221233232319:F342112212000:A23121141:"
<ResultSet apiVersion="1.27.0.0" engineVersion="201805_03a">
<Course searchType="plain" dataType="plain">
:
<Price kind="Teiki1Summary">
<Oneway>4930</Oneway> <!-- 中学の通学定期代になってますね! -->
</Price>
:

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

弊社が提供するHTML5インターフェースサンプルでは、今回のリリース内容を反映させておりますのでぜひご利用ください。

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

github.com

f:id:hiiiiiiihikaru:20180528184758p:plain

終わりに

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