はじめに
定期券
交通費精算(定期区間控除)
通勤費管理(定期代支給)
探索
運賃
探索結果
探索条件
地点
路線
路線図

探索結果からシェイプ情報を取得する

経路探索結果を利用して、経路のシェイプ情報(地図に経路をポリライン描画するための情報)を取得します。

※ポリライン描画のイメージ図(高円寺--JR中央・総武線各駅停車--中野(東京都)--東京メトロ東西線--高田馬場) Course shape sample

関連URL

手順

1. 経路を探索する

ダイヤによる探索を利用して、シェイプ情報を取得したい経路の情報を取得します。

例は経路探索 /search/course/extreme ですが、ダイヤによる探索を行うことができるAPI(経路簡易探索)でも可能です。

※リクエスト例では日本語で記述しておりますが、リクエストパラメータに日本語が含まれる場合には、日本語の部分をUTF8でURLエンコード(パーセントエンコード)してください。

GET /v1/xml/search/course/extreme?key=アクセスキーを入力してください&viaList=高円寺:高田馬場&date=20211211&time=1310&answerCount=1
<ResultSet apiVersion="1.27.0.0" engineVersion="202112_05a">
  <Course searchType="departure" dataType="onTimetable">
    <Route tindex="1" ...>
      <Point index="1">
        <Station code="22671">
          <Name>高円寺</Name>
          :
        </Station>
        :
      </Point>
      <Line index="1" ...>
        <Name>JR総武線・千葉行</Name>
        <Type>train</Type>
        <Color>255222000</Color>
        :
      </Line>
      <Point index="2">
        <Station code="22849">
          <Name>中野(東京都)</Name>
          :
        </Station>
        :
      </Point>
      <Line index="2" ...>
        <Name>東京メトロ東西線・西船橋行</Name>
        <Type>train</Type>
        <Color>000175239</Color>
        :
      </Line>
      <Point index="3">
        <Station code="22790">
          <Name>高田馬場</Name>
          :
        </Station>
        :
      </Point>
    </Route>
    :
    <SerializeData>経路シリアライズデータ</SerializeData>
    :
  </Course>
</ResultSet>

2. 経路のシェイプ情報を取得する

1で取得できる経路シリアライズデータを利用して、シェイプ情報を取得します。

探索経路に鉄道以外の区間が含まれている場合、鉄道以外の区間の運行路線パターンは返りませんのでご注意ください。

GET /v1/xml/course/shape?key=アクセスキーを入力してください&serializeData=1で取得できる経路シリアライズデータを入れてください&checkEngineVersion=false
<ResultSet apiVersion="1.27.0.0" engineVersion="202112_05a">
  <Course dataType="onTimetable">
    <OperationLinePattern routeLineIndex="1">
      <Point index="1">
        <Station code="22671">
          <Name>高円寺</Name>
          :
        </Station>
        :
      </Point>
      <Line index="1" ...>
        <Name>JR中央・総武線各駅停車</Name>
        <Shape index="1">
          <GeoPoint longi_d="139.6497" lati_d="35.70532406" gcs="wgs84"/>
        </Shape>
        <Shape index="2">
          <GeoPoint longi_d="139.64992" lati_d="35.70533" gcs="wgs84"/>
        </Shape>
        :
        <Shape index="11">
          <GeoPoint longi_d="139.66482" lati_d="35.70551" gcs="wgs84"/>
        </Shape>
        <Shape index="12">
          <GeoPoint longi_d="139.666085" lati_d="35.705555" gcs="wgs84"/>
        </Shape>
      </Line>
      <Point index="2">
        <Station code="22849">
          <Name>中野(東京都)</Name>
          :
        </Station>
        :
      </Point>
    </OperationLinePattern>
    <OperationLinePattern routeLineIndex="2">
      <Point index="1">
        <Station code="22849">
          <Name>中野(東京都)</Name>
          :
        </Station>
        :
      </Point>
      <Line index="1" ...>
        <Name>東京メトロ東西線</Name>
        <Shape index="1">
          <GeoPoint longi_d="139.665605" lati_d="35.70574" gcs="wgs84"/>
        </Shape>
        <Shape index="2">
          <GeoPoint longi_d="139.66688" lati_d="35.70579" gcs="wgs84"/>
        </Shape>
        :
        <Shape index="53">
          <GeoPoint longi_d="139.70406" lati_d="35.71376" gcs="wgs84"/>
        </Shape>
        <Shape index="54">
          <GeoPoint longi_d="139.705045" lati_d="35.71328" gcs="wgs84"/>
        </Shape>
      </Line>
      <Point index="2">
        <Station code="22790">
          <Name>高田馬場</Name>
          :
        </Station>
        :
      </Point>
    </OperationLinePattern>
  </Course>
</ResultSet>

鉄道区間ごとに、経路の区間に紐づく運行路線パターン ResultSet/Course/OperationLinePattern が返ります。

地図サービスなどにポリラインを描画する際は、 ResultSet/Course/OperationLinePattern/Line/Shape/GeoPoint 要素配下の座標情報をindex順に連結してご利用ください。

なお、地図サービス上へのポリラインの描画方法につきましては、各サービスの仕様をご確認ください。

ページ上部へ

デベロッパーファーストの

経路検索・運賃計算API