路線図一覧
路線図の一覧を取得します。
駅コードもしくは駅の名称を指定した場合は、指定した駅の存在する一番詳細な路線図の情報を取得できます。
戻り値の一つである、路線図の中心駅は、弊社が推奨する駅となります。
意図せず駅の削除や変更があった場合、中心駅(ResultSet/RailMap/Point
)は返りません。
GET /v1/{format}/railmap/list
parameters
※ Requiredの「△」は、特定の条件においてそのパラメータが必須になることを示します。詳しくはパラメータのDescriptionを参照してください。
Name | Type | Required | Description |
---|---|---|---|
format | string | ◯ | レスポンスのデータ形式の指定。必須 指定できる値: - xml: xml形式のデータ - json: json形式のデータ ※クエリパラメータではなくパスに値を指定します。 |
key | string | ◯ | アクセスキー。必須 |
id | string | --- | 路線図のID。stationCode, stationNameと排他。省略可。省略時は全ての路線図を対象とします。 |
stationCode | int | --- | 駅コード。id, stationNameと排他。省略可 |
stationName | string | --- | 駅の名称。id, stationCodeと排他。省略可 |
gcs | string | --- | リクエストやレスポンスに座標が含まれる場合、座標の測地系を指定することができます。また、リクエストパラメータの座標情報はgcsパラメータとは別の測地系を個別に指定可能です。省略可 指定できる値: - tokyo: 日本測地系 - wgs84: 世界測地系 Default: tokyo |
response
Name | Description |
---|---|
ResultSet | レスポンスの最下部を表す要素 |
ResultSet / apiVersion | WebAPIバージョン |
ResultSet / engineVersion | エンジンバージョン |
ResultSet / RailMap | 路線図を表す要素 |
ResultSet / RailMap / groupIndex | 路線図のグループインデックス |
ResultSet / RailMap / height | 路線図の縦幅 |
ResultSet / RailMap / id | 路線図のID |
ResultSet / RailMap / index | インデックス ※ jsonデータ形式のレスポンスにインデックスは含まれません。JSON形式のレスポンスデータを利用する際の注意事項 |
ResultSet / RailMap / width | 路線図の横幅 |
ResultSet / RailMap / DisprayName | 表示名称を表す要素 |
ResultSet / RailMap / GroupName | グループ名称を表す要素 |
ResultSet / RailMap / Name | 名称を表す要素 |
ResultSet / RailMap / Point | 路線図の中心駅を表す要素 |
ResultSet / RailMap / Point / GeoPoint | 座標を表す要素 |
ResultSet / RailMap / Point / GeoPoint / gcs | 測地系 - tokyo: 日本測地系 - wgs84: 世界測地系 |
ResultSet / RailMap / Point / GeoPoint / lati | 緯度。度分秒(DMS)単位。秒は小数第3位を四捨五入。 Format: 度.分.秒.1/100秒 Example: 35.42.6.0 |
ResultSet / RailMap / Point / GeoPoint / lati_d | 緯度。十進法度(DD)単位。 Format: 度 Example: 35.701667 |
ResultSet / RailMap / Point / GeoPoint / longi | 経度。度分秒(DMS)単位。秒は小数第3位を四捨五入。 Format: 度.分.秒.1/100秒 Example: 139.38.22.30 |
ResultSet / RailMap / Point / GeoPoint / longi_d | 経度。十進法度(DD)単位。 Format: 度 Example: 139.639527 |
ResultSet / RailMap / Point / Prefecture | 都道府県を表す要素 |
ResultSet / RailMap / Point / Prefecture / code | 都道府県コード |
ResultSet / RailMap / Point / Prefecture / Name | 都道府県の名称を表す要素 |
ResultSet / RailMap / Point / Station | 駅を表す要素 |
ResultSet / RailMap / Point / Station / code | 駅コード |
ResultSet / RailMap / Point / Station / Name | 駅の名称を表す要素 |
ResultSet / RailMap / Point / Station / Type | 交通種別を表す要素 |
ResultSet / RailMap / Point / Station / Type / detail | 交通種別の詳細。複数の場合は: 区切り。 |
ResultSet / RailMap / Point / Station / Yomi | 駅の読みかなを表す要素 |
ResultSet / RailMap / Version | バージョンを表す要素 |
ResultSet / RailMap / Version / create | 付帯するデータ等の作成された日付 Format: yyyymmdd |
ResultSet / RailMap / Version / createType | createの解釈方法 - Date: 日付と解釈 - Edition: 日を版数と解釈 - HideDay: 年月のみ有効 |
example
GET /v1/xml/railmap/list?key=アクセスキーを入力してください
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201110_02a">
<RailMap id="c_12abc" width="1283" height="934" index="3" groupIndex="51">
<Point>
<Prefecture code="12">
<Name>千葉県</Name>
</Prefecture>
<GeoPoint gcs="tokyo" lati_d="35.869555" longi_d="140.0137217777778" lati="35.52.10.39" longi="140.0.49.39"/>
<Station code="22183">
<Name>我孫子</Name>
<Yomi>あびこ</Yomi>
<Type>train</Type>
</Station>
</Point>
<Name>我孫子市</Name>
<GroupName>コミュニティバス/千葉</GroupName>
<DisplayName>我孫子市</DisplayName>
<Version create="20120508" createType="Date"/>
</RailMap>
<RailMap id="b_bchs" width="11600" height="5704" index="2" groupIndex="34">
<Point>
<Prefecture code="35">
<Name>山口県</Name>
</Prefecture>
<GeoPoint gcs="tokyo" lati_d="34.048138" longi_d="131.804749" lati="34.2.53.29" longi="131.48.17.9"/>
<Station code="27528">
<Name>徳山</Name>
<Yomi>とくやま</Yomi>
<Type>train</Type>
</Station>
</Point>
<Name>防長バス(南部)</Name>
<GroupName>路線バス/山口</GroupName>
<DisplayName>防長バス(南部)</DisplayName>
<Version create="20130213" createType="Date"/>
</RailMap>
<RailMap id="b_bchn" width="7391" height="5765" index="1" groupIndex="34">
<Point>
<Prefecture code="35">
<Name>山口県</Name>
</Prefecture>
<GeoPoint gcs="tokyo" lati_d="34.407057" longi_d="131.405321" lati="34.24.25.40" longi="131.24.19.15"/>
<Station code="758036">
<Name>萩バスセンター/防長バス</Name>
<Yomi>はぎばすせんたー</Yomi>
<Type detail="local">bus</Type>
</Station>
</Point>
<Name>防長バス(北部)</Name>
<GroupName>路線バス/山口</GroupName>
<DisplayName>防長バス(北部)</DisplayName>
<Version create="20110912" createType="Date"/>
</RailMap>
<RailMap id="b_ask" width="1577" height="1074" index="2" groupIndex="18">
<Point>
<Prefecture code="12">
<Name>千葉県</Name>
</Prefecture>
<GeoPoint gcs="tokyo" lati_d="35.609444" longi_d="140.1172222222222" lati="35.36.33.99" longi="140.7.1.99"/>
<Station code="22361">
<Name>千葉</Name>
<Yomi>ちば</Yomi>
<Type>train</Type>
</Station>
</Point>
<Name>あすか交通</Name>
<GroupName>路線バス/千葉</GroupName>
<DisplayName>あすか交通</DisplayName>
<Version create="20110302" createType="Date"/>
</RailMap>
<RailMap id="b_asj" width="1803" height="2048" index="1" groupIndex="17">
<Point>
<Prefecture code="11">
<Name>埼玉県</Name>
</Prefecture>
<GeoPoint gcs="tokyo" lati_d="35.978055" longi_d="139.6561111111111" lati="35.58.41.0" longi="139.39.21.99"/>
<Station code="22100">
<Name>蓮田</Name>
<Yomi>はすだ</Yomi>
<Type>train</Type>
</Station>
</Point>
<Name>朝日自動車</Name>
<GroupName>路線バス/埼玉</GroupName>
<DisplayName>朝日自動車</DisplayName>
<Version create="20131024" createType="Date"/>
</RailMap>
<RailMap>
:
</RailMap>
</ResultSet>
GET /v1/json/railmap/list?key=アクセスキーを入力してください
{
"ResultSet": {
"apiVersion": "1.14.0.0",
"engineVersion": "201110_02a",
"RailMap": [
{
"id": "tokyo",
"width": "3560",
"height": "3099",
"groupIndex": "0",
"Point": {
"Prefecture": {
"code": "13",
"Name": "東京都"
},
"GeoPoint": {
"gcs": "tokyo",
"lati_d": "35.678082",
"longi_d": "139.770443",
"lati": "35.40.41.9",
"longi": "139.46.13.59"
},
"Station": {
"code": "22828",
"Name": "東京",
"Yomi": "とうきょう",
"Type": "train"
}
},
"Name": "東京近郊",
"DisplayName": "東京近郊",
"Version": {
"create": "20130912",
"createType": "Date"
}
},
{
"id": "fukuoka",
"width": "1358",
"height": "1462",
"groupIndex": "0",
"Point": {
"Prefecture": {
"code": "40",
"Name": "福岡県"
},
"GeoPoint": {
"gcs": "tokyo",
"lati_d": "33.586444",
"longi_d": "130.422860",
"lati": "33.35.11.19",
"longi": "130.25.22.29"
},
"Station": {
"code": "28283",
"Name": "博多",
"Yomi": "はかた",
"Type": "train"
}
},
"Name": "福岡近郊",
"DisplayName": "福岡近郊",
"Version": {
"create": "20130514",
"createType": "Date"
}
},
{
"id": "nagoya",
"width": "1736",
"height": "1815",
"groupIndex": "0",
"Point": {
"Prefecture": {
"code": "23",
"Name": "愛知県"
},
"GeoPoint": {
"gcs": "tokyo",
"lati_d": "35.1675",
"longi_d": "136.885555",
"lati": "35.10.2.99",
"longi": "136.53.7.99"
},
"Station": {
"code": "25077",
"Name": "名古屋",
"Yomi": "なごや",
"Type": "train"
}
},
"Name": "名古屋近郊",
"DisplayName": "名古屋近郊",
"Version": {
"create": "20130212",
"createType": "Date"
}
},
{
"id": "osaka",
"width": "3461",
"height": "2500",
"groupIndex": "0",
"Point": {
"Prefecture": {
"code": "27",
"Name": "大阪府"
},
"GeoPoint": {
"gcs": "tokyo",
"lati_d": "34.698721",
"longi_d": "135.497943",
"lati": "34.41.55.39",
"longi": "135.29.52.59"
},
"Station": {
"code": "25853",
"Name": "大阪",
"Yomi": "おおさか",
"Type": "train"
}
},
"Name": "大阪近郊",
"DisplayName": "大阪近郊",
"Version": {
"create": "20130924",
"createType": "Date"
}
},
{
"id": "b_kkt",
"width": "4802",
"height": "4235",
"groupIndex": "38",
"Point": {
"Prefecture": {
"code": "39",
"Name": "高知県"
},
"GeoPoint": {
"gcs": "tokyo",
"lati_d": "33.563611",
"longi_d": "133.545833",
"lati": "33.33.48.99",
"longi": "133.32.44.99"
},
"Station": {
"code": "27968",
"Name": "高知",
"Yomi": "こうち",
"Type": "train"
}
},
"Name": "高知県交通",
"GroupName": "路線バス/高知",
"DisplayName": "高知県交通(県交北部交通)",
"Version": {
"create": "20120111",
"createType": "Date"
}
},
{
:
}
]
}
}