経路探索結果のシェイプ情報

経路探索結果(経路シリアライズデータ)から、経路のシェイプ情報(地図に経路をポリライン描画するための情報)を取得します。
レスポンスとしては、経路の区間(ResultSet / Course / Route / Line)とインデックスで紐づく運行路線パターン(ResultSet / Course / OperationLinePattern)の区間毎にシェイプポイントの情報が返ります。


 Attention!

シェイプ情報が取得できるのは鉄道区間のみです。鉄道以外の区間の場合は運行路線パターンが返りません。
また、平均待ち時間による探索経路シリアライズデータは利用できません。

GET /v1/{format}/course/shape

parameters

※ Requiredの「△」は、特定の条件においてそのパラメータが必須になることを示します。詳しくはパラメータのDescriptionを参照してください。

Name Type Required Description
format string レスポンスのデータ形式の指定。必須
Values:
- xml: xml形式のデータ
- json: json形式のデータ
※クエリパラメータではなくパスに値を指定します。
key string アクセスキーの指定。必須
serializeData string 経路シリアライズデータ。必須
checkEngineVersion string --- 完全な経路シリアライズデータの再現を行う場合は、シリアライズデータ作成時のエンジンバージョンと再現時のエンジンバージョンが同一かのチェックを有効にします。エンジンバージョンが異なる場合は、エラーを返します。省略可。
指定できる値:
- true: チェックする
- false: チェックしない
Default: true

response

Name Description
ResultSet / apiVersion WebAPIバージョン
ResultSet / engineVersion エンジンバージョン
ResultSet / Course 経路探索の結果である経路を表す要素
ResultSet / Course / dataType 時刻を元にした探索結果かどうか。
- onTimetable: 時刻に基づく探索
ResultSet / Course / OperationLinePattern 経路の区間に紐づく運行路線パターンを表す要素。
OperationLinePatternは複数返る可能性があります。
※ 経路の区間が鉄道以外の場合は返りません。
ResultSet / Course / OperationLinePattern / routeLineIndex ResultSet / Course / Route / Line /indexと紐づくインデックス
ResultSet / Course / OperationLinePattern / Point 地点 を表す要素
ResultSet / Course / OperationLinePattern / Point / index インデックス。
※ jsonデータ形式のレスポンスにインデックスは含まれません。JSON形式のレスポンスデータを利用する際の注意事項
ResultSet / Course / OperationLinePattern / Point / Station を表す要素
ResultSet / Course / OperationLinePattern / Point / Station / code 駅コード
ResultSet / Course / OperationLinePattern / Point / Station / Name 駅の名称を表す要素
ResultSet / Course / OperationLinePattern / Point / Station / Type 交通種別を表す要素
ResultSet / Course / OperationLinePattern / Point / Station / Yomi の読みかなを表す要素
ResultSet / Course / OperationLinePattern / Point / Prefecture 都道府県を表す要素
ResultSet / Course / OperationLinePattern / Point / Prefecture / code 都道府県コード
ResultSet / Course / OperationLinePattern / Point / Prefecture / Name 都道府県の名称を表す要素
ResultSet / Course / OperationLinePattern / Line 運行路線を表す要素
ResultSet / Course / OperationLinePattern / Line / index インデックス。
※ jsonデータ形式のレスポンスにインデックスは含まれません。JSON形式のレスポンスデータを利用する際の注意事項
ResultSet / Course / OperationLinePattern / Line / code 運行路線コード
ResultSet / Course / OperationLinePattern / Line / direction 方向
ResultSet / Course / OperationLinePattern / Line / fromStationPos 区間発駅番号
ResultSet / Course / OperationLinePattern / Line / toStationPos 区間着駅番号
ResultSet / Course / OperationLinePattern / Line / track 軌道種別
ResultSet / Course / OperationLinePattern / Line / Name 運行路線名称を表す要素
ResultSet / Course / OperationLinePattern / Line / Shape シェイプポイントを表す要素
Shapeは複数返る可能性があります。
ResultSet / Course / OperationLinePattern / Line / Shape / index シェイプポイントの連結順序
※ jsonデータ形式のレスポンスにインデックスは含まれません。JSON形式のレスポンスデータを利用する際の注意事項
ResultSet / Course / OperationLinePattern / Line / Shape / GeoPoint 座標を表す要素
ResultSet / Course / OperationLinePattern / Line / Shape / GeoPoint / gcs 測地系
- wgs84: 世界測地系
※ gcsパラメータでの測地系変換には未対応です。
ResultSet / Course / OperationLinePattern / Line / Shape / GeoPoint / lati_d 緯度
Format: 度
ResultSet / Course / OperationLinePattern / Line / Shape / GeoPoint / longi_d 経度
Format: 度

example

GET /v1/xml/course/shape?key=アクセスキーを入力してください&serializeData=VkV4QaECp7jJAsMCpgE0ZgEDpgE0ZgEEksIBQwgBAgKmATRlrcIBQwAAAAKmATRmAQPKAQECAQMBBAEHAQgBCgIPQv9_EKX_9xSSpViPpVkGBZrBAqWzPcECpbJIwQKlWI_BAqVZBsECpVkSwQKlV4HBAqVZysECpVgfwQKlsuXBAqVZQQaUwwECAgYDxAGlASECDQMPBKUCfcMBAwIFA8EBAcMBAQIBA8cBpU|kAgYDCQWkeQZFMTYwNFkHBggFwwEBAgEDxwGlCqUCCgMQBaR5BkUxNjA1RwcHCAcHlMUBpgE0ZbIDpQPGBKUD1AUACADGAaYBNGWyAgEDpQPVBKUD1gUACADGAaYBNGWyAgIDpQPZBKUD4gUACADGAaYBNGWyAgMDpQPoBKUD9gUACAAIlcYEAQUCBgIHpQE|CAgJUIrWk4yDb4NYgUWNgoJVgk_FAgEEAgUCBwEJRJNrleDFAgIECQUBB6RuCAnGAgkEAwUBBgEHpQFLCAPGAgMEBAUBBgEHpQLNCAQJk8EDAcMBAgICAwHDAQMCAwMBCpLBAwnCAQICAw|RxQGVAAECAwQClMMBAAIAAwDDAQECAQMBwwECAgIDA8MBAwIEAwQDlcMBAAIAAwDDAQECAQMBwwECAgIDAsMBAwICAwLDAQQCAwMDBJMAAQIFkQA*--T32212332323191:F3321122120000:A23121141:--53cf77ae08d712d10fe1dcb53a25c78413d95c2a--1--1--1--509&checkEngineVersion=false
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.27.0.0" engineVersion="202112_01a">
   <Course dataType="onTimetable">
      <OperationLinePattern routeLineIndex="3">
         <Point index="1">
            <Station code="22671">
               <Name>高円寺</Name>
               <Type>train</Type>
               <Yomi>こうえんじ</Yomi>
            </Station>
            <Prefecture code="13">
               <Name>東京都</Name>
            </Prefecture>
         </Point>
         <Line direction="Up" track="railway" toStationPos="420" index="1" fromStationPos="430" code="110">
            <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="12">
               <GeoPoint longi_d="139.666085" lati_d="35.705555" gcs="wgs84" />
            </Shape>
         </Line>
         <Point index="2">
            <Station code="22849">
               <Name>中野(東京都)</Name>
               <Type>train</Type>
               <Yomi>なかの</Yomi>
            </Station>
            <Prefecture code="13">
               <Name>東京都</Name>
            </Prefecture>
         </Point>
         <Line direction="Down" track="railway" toStationPos="120" index="2" fromStationPos="100" code="331">
            <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="54">
               <GeoPoint longi_d="139.705045" lati_d="35.71328" gcs="wgs84" />
            </Shape>
         </Line>
         <Point index="3">
            <Station code="22790">
               <Name>高田馬場</Name>
               <Type>train</Type>
               <Yomi>たかだのばば</Yomi>
            </Station>
            <Prefecture code="13">
               <Name>東京都</Name>
            </Prefecture>
         </Point>
      </OperationLinePattern>
      <OperationLinePattern routeLineIndex="4">
        :
      </OperationLinePattern>
   </Course>
</ResultSet>
GET /v1/json/course/shape?key=アクセスキーを入力してください&serializeData=VkV4QaECp7jJAsMCpgE0ZgEDpgE0ZgEEksIBQwgBAgKmATRlrcIBQwAAAAKmATRmAQPKAQECAQMBBAEHAQgBCgIPQv9_EKX_9xSSpViPpVkGBZrBAqWzPcECpbJIwQKlWI_BAqVZBsECpVkSwQKlV4HBAqVZysECpVgfwQKlsuXBAqVZQQaUwwECAgYDxAGlASECDQMPBKUCfcMBAwIFA8EBAcMBAQIBA8cBpU|kAgYDCQWkeQZFMTYwNFkHBggFwwEBAgEDxwGlCqUCCgMQBaR5BkUxNjA1RwcHCAcHlMUBpgE0ZbIDpQPGBKUD1AUACADGAaYBNGWyAgEDpQPVBKUD1gUACADGAaYBNGWyAgIDpQPZBKUD4gUACADGAaYBNGWyAgMDpQPoBKUD9gUACAAIlcYEAQUCBgIHpQE|CAgJUIrWk4yDb4NYgUWNgoJVgk_FAgEEAgUCBwEJRJNrleDFAgIECQUBB6RuCAnGAgkEAwUBBgEHpQFLCAPGAgMEBAUBBgEHpQLNCAQJk8EDAcMBAgICAwHDAQMCAwMBCpLBAwnCAQICAw|RxQGVAAECAwQClMMBAAIAAwDDAQECAQMBwwECAgIDA8MBAwIEAwQDlcMBAAIAAwDDAQECAQMBwwECAgIDAsMBAwICAwLDAQQCAwMDBJMAAQIFkQA*--T32212332323191:F3321122120000:A23121141:--53cf77ae08d712d10fe1dcb53a25c78413d95c2a--1--1--1--509&checkEngineVersion=false
{
   "ResultSet": {
      "apiVersion": "1.27.0.0",
      "engineVersion": "202112_01a",
      "Course": {
         "dataType": "onTimetable",
         "OperationLinePattern": [
            {
               "routeLineIndex": "3",
               "Line": [
                  {
                     "direction": "Up",
                     "track": "railway",
                     "toStationPos": "420",
                     "fromStationPos": "430",
                     "code": "110",
                     "Name": "JR中央・総武線各駅停車",
                     "Shape": [
                        {
                           "GeoPoint": {
                              "longi_d": "139.6497",
                              "lati_d": "35.70532406",
                              "gcs": "wgs84"
                           }
                        },
                        {
                           "GeoPoint": {
                              "longi_d": "139.64992",
                              "lati_d": "35.70533",
                              "gcs": "wgs84"
                           }
                        },
                          :
                        {
                           "GeoPoint": {
                              "longi_d": "139.666085",
                              "lati_d": "35.705555",
                              "gcs": "wgs84"
                           }
                        }
                     ]
                  },
                  {
                     "direction": "Down",
                     "track": "railway",
                     "toStationPos": "120",
                     "fromStationPos": "100",
                     "code": "331",
                     "Name": "東京メトロ東西線",
                     "Shape": [
                        {
                           "GeoPoint": {
                              "longi_d": "139.665605",
                              "lati_d": "35.70574",
                              "gcs": "wgs84"
                           }
                        },
                        {
                           "GeoPoint": {
                              "longi_d": "139.66688",
                              "lati_d": "35.70579",
                              "gcs": "wgs84"
                           }
                        },
                          :
                        {
                           "GeoPoint": {
                              "longi_d": "139.705045",
                              "lati_d": "35.71328",
                              "gcs": "wgs84"
                           }
                        }
                     ]
                  }
               ],
               "Point": [
                  {
                     "Station": {
                        "code": "22671",
                        "Name": "高円寺",
                        "Type": "train",
                        "Yomi": "こうえんじ"
                     },
                     "Prefecture": {
                        "code": "13",
                        "Name": "東京都"
                     }
                  },
                  {
                     "Station": {
                        "code": "22849",
                        "Name": "中野(東京都)",
                        "Type": "train",
                        "Yomi": "なかの"
                     },
                     "Prefecture": {
                        "code": "13",
                        "Name": "東京都"
                     }
                  },
                  {
                     "Station": {
                        "code": "22790",
                        "Name": "高田馬場",
                        "Type": "train",
                        "Yomi": "たかだのばば"
                     },
                     "Prefecture": {
                        "code": "13",
                        "Name": "東京都"
                     }
                  }
               ]
            },
            {
               "routeLineIndex": "4",
               "Line": {
                  :
               },
               "Point": [
                  :
               ]
            }
         ]
      }
   }
}
ページ上部へ

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

経路検索・運賃計算API