路線図関連API - 路線図駅情報

機能別リファレンスへ戻る

https://api.apigw.smt.docomo.ne.jp/ekispertCorp/v1/railmapDetail

※ レスポンスヘッダのContent-Typeについて

路線図駅情報

路線図上の駅情報を取得します。

駅コードと駅名称について

駅を特定するデータとして「駅コード」または「駅名称」を利用することができますが、保存を前提として利用する場合は「駅コード」を推奨します。「駅名称」は駅名改称等で変更される可能性がありますが、「駅名称」に紐づく「駅コード」は「駅名称」の変更に関わらず不変です。

リクエストパラメータ

※ APIキーを別途リクエストパラメータに含める必要があります(詳細)
※ リクエストやレスポンスに座標が含まれる場合、座標の測地系をgcsパラメータで指定することができます(詳細)
※ リクエストパラメータに日本語が含まれる場合には、UTF8でURLエンコードしてください(詳細)

名称データ型説明
idstring路線図のID
stationNamestring駅すぱあとの駅名称。名称を指定した場合は指定した駅の情報のみを取得します (省略可。stationCode, x, y, width, heightと排他)
stationCodeint駅すぱあとの駅コード。コードを指定した場合は指定した駅の情報のみを取得します (省略可。stationName, x, y, width, heightと排他)
xint路線図X座標。情報取得の起点となる路線図座標Xを指定します (省略可。stationCode, stationNameと排他。width, height指定時に省略すると0として扱われます)
yint路線図Y座標。情報取得の起点となる路線図座標Yを指定します (省略可。stationCode, stationNameと排他。width, height指定時に省略すると0として扱われます)
widthint横幅指定。横軸起点Xからの幅を指定します。指定可能な値は1から500となります (省略可。height指定時必須。stationCode, stationNameと排他)
heightint縦幅指定。縦軸起点Yからの幅を指定します。指定可能な値は1から500となります (省略可。width指定時必須。stationCode, stationNameと排他)

レスポンスデータ

名称説明
ResultSetルート要素
 apiVersionWebAPIのバージョン
 engineVersionエンジンのバージョン
 RailMap路線図を表す要素
  height路線図の縦幅
  id路線図のID
  width路線図の横幅
  x路線図のX座標
  y路線図のY座標
  Point路線図の中心駅を表す要素
   GeoPoint座標を表す要素
    gcs測地系
    lati緯度 (度.分.秒.100分の1秒)
    lati_d緯度 (度)
    longi経度 (度.分.秒.100分の1秒)
    longi_d経度 (度)
   MarkCoordinates路線図の選択座標を表す要素
    chamfering面取り判定
    height縦幅
    isTexttrue:路線図の名称部分を表す
    r半径
    shape座標の形
    width横幅
    xX座標
    yY座標
   Prefecture都道府県を表す要素
    code都道府県コード
    Name名称を表す要素
   Station駅を表す要素
    code駅コード
    Name名称を表す要素
    Type交通種別を表す要素
    Yomi読みかなを表す要素
レスポンス例(JSON)
リクエストURL:
https://api.apigw.smt.docomo.ne.jp/ekispertCorp/v1/railmapDetail?APIKEY=xxxxxxxxxx
&id=tokyo&x=3000&y=600&width=500&height=500
リクエストcURL:
curl -i -X GET 'https://api.apigw.smt.docomo.ne.jp/ekispertCorp/v1/railmapDetail?APIKEY=xxxxxxxxxx
&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.639639",
            "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.934167",
            "longi_d": "140.552944",
            "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.913722",
            "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.891806",
            "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"
          }
        },
        "...(略)..."
      ]
    }
  }
}