路線図の領域内に存在する駅名を取得する

指定した路線図の領域内に存在する駅を取得します。

路線図画像を利用して取得した路線図の画像から、 「駅をクリックして駅の情報を取得する」仕組みを作成する場合に必要となります。

関連URL

手順

1. 路線図IDを取得する

路線図を取得するには、まず路線図のIDを取得する必要があります。
路線図のIDは路線図一覧で取得します。
※リクエスト例では、東京駅(駅コード22828)付近の一番詳細な路線図の情報を取得します。

GET /v1/xml/railmap/list?key=アクセスキーを入力してください&stationCode=22828
<ResultSet apiVersion="1.27.0.0" engineVersion="201708_03a">
  <RailMap width="3560" groupIndex="0" index="0" height="3100" id="tokyo">
    <Name>東京近郊</Name>
    <Version create="20170615" createType="Date"/>
    <DisplayName>東京近郊</DisplayName>
    <Point>
      :
    </Point>
    <GroupName/>
  </RailMap>
</ResultSet>

id="tokyo"が取得できました。この"tokyo"が路線図のIDとなります。

2. 路線図画像の領域内に存在する駅名を取得する

路線図の指定した領域内に存在する駅名を路線図駅情報で取得します。

/v1/xml/railmap/detail?key=アクセスキーを入力してください&id=tokyo&x=1700&y=1400&width=500&height=500
<ResultSet apiVersion="1.27.0.0" engineVersion="201708_03a">
  <RailMap width="500" x="1700" y="1400" height="500" id="tokyo">
    <Point>
      <Station code="22709">
        <Name>品川</Name>
        <Type>train</Type>
        <Yomi>しながわ</Yomi>
      </Station>
      <GeoPoint longi="139.44.31.0" lati="35.37.31.0" longi_d="139.741944" gcs="tokyo" lati_d="35.625278"/>
      <Prefecture code="13">
        <Name>東京都</Name>
      </Prefecture>
      <MarkCoordinates width="122" isText="true" shape="rect" chamfering="true" x="80" y="443" height="459"/>
    </Point>
    <Point>
      <Station code="22918">
        <Name>馬喰町</Name>
        <Type>train</Type>
        <Yomi>ばくろちょう</Yomi>
      </Station>
      <GeoPoint longi="139.47.8.50" lati="35.41.24.59" longi_d="139.785694" gcs="tokyo" lati_d="35.690166"/>
      <Prefecture code="13">
        <Name>東京都</Name>
      </Prefecture>
      <MarkCoordinates width="420" isText="true" shape="rect" chamfering="false" x="408" y="41" height="77"/>
      <MarkCoordinates isText="false" shape="circle" r="4" chamfering="false" x="414" y="82"/>
    </Point>
    <Point>
      :
    </Point>
  </RailMap>
</ResultSet>

note

2のリクエスト例のxmlpngdetaildataに置き換えることで、指定した路線図の領域内にどんな駅が存在するのか、視覚的に確かめることができます。

GET /v1/png/railmap/data?key=アクセスキーを入力してください&id=tokyo&x=1700&y=1400&width=500&height=500

data

※ 路線図画像の取得については、路線図の画像を取得するで詳しく説明しています。

駅すぱあとWebサービス HTML5 インターフェースサンプルで様々なデモを用意していますので、ぜひご確認ください。

また、スマートフォンサイトやスマートフォンアプリでも路線図を利用したい場合は、 Javascriptで操作ができるAPI「駅すぱあと路線図」がお勧めです。詳しくはリンク先をご覧ください。