路線図駅情報
路線図上の駅情報を取得します。
GET /v1/{format}/railmap/detail
parameters
※ Requiredの「△」は、特定の条件においてそのパラメータが必須になることを示します。詳しくはパラメータのDescriptionを参照してください。
Name | Type | Required | Description |
---|---|---|---|
format | string | ◯ | レスポンスのデータ形式の指定。必須 指定できる値: - xml: xml形式のデータ - json: json形式のデータ ※クエリパラメータではなくパスに値を指定します。 |
key | string | ◯ | アクセスキー。必須 |
id | string | ◯ | 路線図のID。必須 |
stationCode | int | △ | 駅コード。指定した駅の情報のみを取得します。stationName, x, y, width, heightと排他。stationName, x, y, width, height無指定時必須。 |
stationName | string | △ | 駅の名称。指定した駅の情報のみを取得します。 stationCode, x, y, width, heightと排他。stationCode, x, y, width, height無指定時必須。 |
x | int | --- | 路線図X座標。情報取得の起点となる路線図座標Xを指定します。stationCode, stationNameと排他。省略可。width, height指定時に省略すると0として扱われます。 |
y | int | --- | 路線図Y座標。情報取得の起点となる路線図座標Yを指定します。stationCode, stationNameと排他。省略可。width, height指定時に省略すると0として扱われます。 |
width | int | △ | 横幅指定。横軸起点Xからの幅を指定します。指定可能な値は1から500です。stationCode, stationNameと排他。height指定時必須 |
height | int | △ | 縦幅指定。縦軸起点Xからの幅を指定します。指定可能な値は1から500です。stationCode, stationNameと排他。width指定時必須 |
response
Name | Description |
---|---|
ResultSet | レスポンスの最下部を表す要素 |
ResultSet / apiVersion | WebAPIバージョン |
ResultSet / engineVersion | エンジンバージョン |
ResultSet / RailMap | 路線図を表す要素 |
ResultSet / RailMap / height | 路線図の縦幅 |
ResultSet / RailMap / id | 路線図のID |
ResultSet / RailMap / index | インデックス ※ jsonデータ形式のレスポンスにインデックスは含まれません。JSON形式のレスポンスデータを利用する際の注意事項 |
ResultSet / RailMap / width | 路線図の横幅 |
ResultSet / RailMap / x | 路線図のX座標 |
ResultSet / RailMap / y | 路線図のY座標 |
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 / MarkCoordinates | 路線図の選択座標を表す要素 |
ResultSet / RailMap / MarkCoordinates / chamfering | 面取り判定 |
ResultSet / RailMap / MarkCoordinates / height | 縦幅 |
ResultSet / RailMap / MarkCoordinates / isText | - true: 路線図の名称部分を表す - false: 表さない |
ResultSet / RailMap / MarkCoordinates / r | 半径 |
ResultSet / RailMap / MarkCoordinates / shape | 座標の形 |
ResultSet / RailMap / MarkCoordinates / width | 横幅 |
ResultSet / RailMap / MarkCoordinates / x | X座標 |
ResultSet / RailMap / MarkCoordinates / y | Y座標 |
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 | 駅の読みかなを表す要素 |
example
GET /v1/xml/railmap/detail?key=アクセスキーを入力してください&id=tokyo&x=3000&y=600&width=500&height=500
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201110_02a">
<RailMap id="tokyo" x="3000" y="600" width="500" height="500">
<Point>
<Prefecture code="8">
<Name>茨城県</Name>
</Prefecture>
<GeoPoint gcs="tokyo" lati_d="35.988971" longi_d="140.639638" lati="35.59.20.29" longi="140.38.22.69"/>
<MarkCoordinates shape="rect" x="417" y="152" width="487" height="195" chamfering="false" isText="true"/>
<MarkCoordinates shape="circle" x="409" y="162" r="4" chamfering="false" isText="false"/>
<Station code="21612">
<Name>鹿島サッカースタジアム</Name>
<Yomi>かしまさっかーすたじあむ</Yomi>
<Type>train</Type>
</Station>
</Point>
<Point>
<Prefecture code="8">
<Name>茨城県</Name>
</Prefecture>
<GeoPoint gcs="tokyo" lati_d="35.934166" longi_d="140.552943" lati="35.56.3.0" longi="140.33.10.59"/>
<MarkCoordinates shape="rect" x="350" y="294" width="378" height="309" chamfering="false" isText="true"/>
<MarkCoordinates shape="circle" x="340" y="300" r="6" chamfering="false" isText="false"/>
<Station code="21588">
<Name>潮来</Name>
<Yomi>いたこ</Yomi>
<Type>train</Type>
</Station>
</Point>
<Point>
<Prefecture code="12">
<Name>千葉県</Name>
</Prefecture>
<GeoPoint gcs="tokyo" lati_d="35.913721" longi_d="140.549083" lati="35.54.49.39" longi="140.32.56.69"/>
<MarkCoordinates shape="rect" x="347" y="336" width="389" height="351" chamfering="false" isText="true"/>
<MarkCoordinates shape="circle" x="340" y="341" r="4" chamfering="false" isText="false"/>
<Station code="22335">
<Name>十二橋</Name>
<Yomi>じゅうにきょう</Yomi>
<Type>train</Type>
</Station>
</Point>
<Point>
<Prefecture code="8">
<Name>茨城県</Name>
</Prefecture>
<GeoPoint gcs="tokyo" lati_d="35.9675" longi_d="140.629444" lati="35.58.3.0" longi="140.37.45.99"/>
<MarkCoordinates shape="rect" x="418" y="223" width="474" height="238" chamfering="false" isText="true"/>
<MarkCoordinates shape="circle" x="410" y="229" r="6" chamfering="false" isText="false"/>
<Station code="21613">
<Name>鹿島神宮</Name>
<Yomi>かしまじんぐう</Yomi>
<Type>train</Type>
</Station>
</Point>
<Point>
<Prefecture code="12">
<Name>千葉県</Name>
</Prefecture>
<GeoPoint gcs="tokyo" lati_d="35.891805" longi_d="140.496944" lati="35.53.30.50" longi="140.29.48.99"/>
<MarkCoordinates shape="rect" x="294" y="357" width="308" height="385" chamfering="false" isText="true"/>
<MarkCoordinates shape="circle" x="302" y="393" r="6" chamfering="false" isText="false"/>
<Station code="22312">
<Name>佐原</Name>
<Yomi>さわら</Yomi>
<Type>train</Type>
</Station>
</Point>
<Point>
:
</Point>
</RailMap>
</ResultSet>
GET /v1/json/railmap/detail?key=アクセスキーを入力してください&id=tokyo&x=3000&y=600&width=500&height=500
{
"ResultSet": {
"apiVersion": "1.14.0.0",
"engineVersion": "201110_02a",
"RailMap": {
"id": "tokyo",
"x": "3000",
"y": "600",
"width": "500",
"height": "500",
"Point": [
{
"Prefecture": {
"code": "8",
"Name": "茨城県"
},
"GeoPoint": {
"gcs": "tokyo",
"lati_d": "35.988971",
"longi_d": "140.639638",
"lati": "35.59.20.29",
"longi": "140.38.22.69"
},
"MarkCoordinates": [
{
"shape": "rect",
"x": "417",
"y": "152",
"width": "487",
"height": "195",
"chamfering": "false",
"isText": "true"
},
{
"shape": "circle",
"x": "409",
"y": "162",
"r": "4",
"chamfering": "false",
"isText": "false"
}
],
"Station": {
"code": "21612",
"Name": "鹿島サッカースタジアム",
"Yomi": "かしまさっかーすたじあむ",
"Type": "train"
}
},
{
"Prefecture": {
"code": "8",
"Name": "茨城県"
},
"GeoPoint": {
"gcs": "tokyo",
"lati_d": "35.934166",
"longi_d": "140.552943",
"lati": "35.56.3.0",
"longi": "140.33.10.59"
},
"MarkCoordinates": [
{
"shape": "rect",
"x": "350",
"y": "294",
"width": "378",
"height": "309",
"chamfering": "false",
"isText": "true"
},
{
"shape": "circle",
"x": "340",
"y": "300",
"r": "6",
"chamfering": "false",
"isText": "false"
}
],
"Station": {
"code": "21588",
"Name": "潮来",
"Yomi": "いたこ",
"Type": "train"
}
},
{
"Prefecture": {
"code": "12",
"Name": "千葉県"
},
"GeoPoint": {
"gcs": "tokyo",
"lati_d": "35.913721",
"longi_d": "140.549083",
"lati": "35.54.49.39",
"longi": "140.32.56.69"
},
"MarkCoordinates": [
{
"shape": "rect",
"x": "347",
"y": "336",
"width": "389",
"height": "351",
"chamfering": "false",
"isText": "true"
},
{
"shape": "circle",
"x": "340",
"y": "341",
"r": "4",
"chamfering": "false",
"isText": "false"
}
],
"Station": {
"code": "22335",
"Name": "十二橋",
"Yomi": "じゅうにきょう",
"Type": "train"
}
},
{
"Prefecture": {
"code": "8",
"Name": "茨城県"
},
"GeoPoint": {
"gcs": "tokyo",
"lati_d": "35.9675",
"longi_d": "140.629444",
"lati": "35.58.3.0",
"longi": "140.37.45.99"
},
"MarkCoordinates": [
{
"shape": "rect",
"x": "418",
"y": "223",
"width": "474",
"height": "238",
"chamfering": "false",
"isText": "true"
},
{
"shape": "circle",
"x": "410",
"y": "229",
"r": "6",
"chamfering": "false",
"isText": "false"
}
],
"Station": {
"code": "21613",
"Name": "鹿島神宮",
"Yomi": "かしまじんぐう",
"Type": "train"
}
},
{
"Prefecture": {
"code": "12",
"Name": "千葉県"
},
"GeoPoint": {
"gcs": "tokyo",
"lati_d": "35.891805",
"longi_d": "140.496944",
"lati": "35.53.30.50",
"longi": "140.29.48.99"
},
"MarkCoordinates": [
{
"shape": "rect",
"x": "294",
"y": "357",
"width": "308",
"height": "385",
"chamfering": "false",
"isText": "true"
},
{
"shape": "circle",
"x": "302",
"y": "393",
"r": "6",
"chamfering": "false",
"isText": "false"
}
],
"Station": {
"code": "22312",
"Name": "佐原",
"Yomi": "さわら",
"Type": "train"
}
},
{
:
}
]
}
}
}