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


 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>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