역 스파아와 웹 서비스의 범위 탐색 API와 역 스파아와 노선도를 조합해 앱을 만들어 보자

발 연구소 Advent Calendar 2018 12일째의 기사입니다.
오늘은 역 스파아토 노선도 과 역 스파아토 웹 서비스 을 조합해 사용하는 예를 소개하겠습니다.

역 스파아토 노선도와 역 스파아토 웹 서비스

10일째 기사 하지만 역 스파아와 노선도를 소개하고 있습니다만, 이번은 역 스파아토 웹 서비스 의 범위 탐색 (/search/multipleRange)의 결과를 노선도에 매핑 해 보겠습니다.

역 스파아토 노선도 에서는, 역 코드 이나 운행 노선 와 같은, 역 스파아토 웹 서비스 로 사용되는 개념을 그대로 이용할 수 있으므로, 양자를 조합해 이용하면, 보다 효과를 얻을 수 있습니다.

역 스파아토 웹 서비스 범위 탐색 API

범위 탐색 (/search/multipleRange) 는 기점이 되는 역과 소요 시간의 상한치를 지정해, 도달 가능한 역의 일람을 취득하는 API 입니다.

작년 Val 연구소 Advent Calendar에서도 범위 탐색 (/search/multipleRange)에 대해 소개하고 있습니다. 흥미가 있는 분은 아울러 보실 수 있으면이라고 생각합니다.

여러 역을 기점으로 한 범위 탐색을 역 빠아토 웹 서비스로 시험해 본다

범위 탐색 결과를 역 샤아와 노선도에 매핑

범위 탐색 의 결과를 역 스파아토 노선도 에 어떻게 매핑하고 있는지는, 실제의 동작 화면을 보고 받는 것이 좋을까 생각합니다.



이 샘플에서는, 도쿄역을 기점역으로 지정해, 소요 시간의 상한치를 변화시켜 갔을 때의 도달 가능 역을 매핑하고 있습니다. 매우 간단한 샘플이지만, 소요 시간을 늘리면 도달 가능한 역이 방사상으로 늘어나는 경향을 볼 수 있습니다. 이것을 응용하면 이사시 가장 가까운 역 선택 등이 편해질지도 모릅니다.

샘플 코드

이번 샘플도 GitHub에서 공개하고 있습니다.

ValLaboratory/advcal

액세스 키 얻기

이 샘플은 역 스파아토 노선도 및 역 스파아토 웹 서비스의 액세스 키가 필요합니다.
역 스파아토 노선도 에는 프리 플랜도 있으므로, 이하보다 신청해 주시면 좋겠습니다.

역 스파아토 노선도 프리 플랜

역 스파아토 웹 서비스 의 액세스 키는 셋째 날 기사 에서 소개한 Amazon SaaS 스토어 에서 구입하시는 것이 좋습니다.

SaaS 스토어에서 역 스파아토 웹 서비스 구매

샘플 코드를 움직여보세요

바로 환경을 구축해 보겠습니다. 노선도의 액세스 키는 work_dir/ews_rosenz_and_multipleRange/setup_ews_rosenz.sh 로 설정해 주십시오.
GUI 샘플 과 같이, 역 스파아와 노선도의 액세스 키를 설정 작업을 setup_ews_rosenz.sh 로 실시하고 있습니다.

아래와 같이 역 스파아토 노선도 의 액세스 키와 역 스파아토 웹 서비스 의 액세스 키를 지정해 스크립트를 실행하면(자), 샘플 코드에 액세스 키를 설정할 수 있습니다.

$ git clone https://github.com/ValLaboratory/advcal.git
$ cd advcal/2018/docker_env/
$
$ # 駅すぱあと路線図と駅すぱあとWebサービスのアクセスキー設定をおこなう
$ ./work_dir/ews_rosenz_and_multipleRange/setup_ews_rosenz.sh <駅すぱあと路線図のアクセスキー> <駅すぱあとWebサービスのアクセスキー>

그리고는 Docker 이미지를 빌드해 컨테이너를 기동합니다.

$ # Dockerイメージをビルドする。
$ docker-compose build ews_rosenz
$ docker-compose up ews_rosenz

컨테이너가 시작되면 웹 브라우저에서 다음 URL을 엽니다.

http://localhost-8080.com/

방금 샘플을 볼 수 있을까 생각합니다. 다음 예에서는 도쿄역에서 200분 이내에 도달할 수 있는 역을 표시합니다. 하치노헤나 가나자와, 히메지 근처까지 이동할 수 있는 것을 봐 받을 수 있네요.

요약

역 스파아토 노선도 과 역 스파아토 웹 서비스 을 조합해 사용하는 예를 소개했습니다.
각각 단독의 서비스로서 이용하는 것도 물론 가능합니다만, 역 스파아토 웹 서비스 밖에 없는 기능·데이터를 취득해 역 스파아토 노선도 과 조합하는 것으로, 이번 샘플과 같은 보여주는 방법도 가능하게 됩니다. 꼭 여러분의 환경에서도 시험해 주시면 좋겠습니다.