経路探索結果のシェイプ情報
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）の区間毎にシェイプポイントの情報が返ります。
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": [
:
]
}
]
}
}
}
