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

Attention!

This page has not been translated into English yet. It is possible that some parts of description may contains old information. Please see Japanese Documents if you need the latest and accurate information.

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

なお、シェイプ情報のデータソース等につきましては、シェイプ情報の提供元をご確認ください。

Attention!

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

GET /v1/{format}/course/shape

parameters

Name	Type	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>ＪＲ中央・総武線各駅停車</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": "ＪＲ中央・総武線各駅停車",
                     "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": [
                  :
               ]
            }
         ]
      }
   }
}