コンテンツにスキップ

鉄道路線形状取得

/transport_shape [GET]

基本情報

概要

鉄道の路線形状を出力することができます。

URL

https://{HOST}/{CID}/v1/transport_shape

出力形式

  • GeoJSON

対応言語

  • ja

パラメータ

パラメータ名 必須 概要 型名 デフォルト値 上下限/選択値 備考
link 路線ID 文字列 最大10路線まで ピリオド区切りで複数指定できます
詳細はこちらをご覧ください
coord_unit 出力データに含まれる緯度経度の単位 文字列 degree degree:度表記の10進法
millisec:ミリ秒表記

linkの取得方法について

路線検索API(/transport_link)」のレスポンスにて返却される「路線ID(id)」を指定してください。
この時、リクエストパラメータに"type=train"を付与してリクエストしてください。

  • 丸ノ内線のノードIDを取得したい場合
/v1/transport_link?word=丸ノ内線&type=train

パラメータ構成例

  • 路線ID「00000766」「00000767」の路線形状情報を取得
/transport/shape?link=00000766.00000767

レスポンス

名称 レスポンス名 型名 配列 説明
種別 type 文字列 "FeatureCollection"固定
形状に関する情報 features Featuresオブジェクト
形状全体のバウンディングボックス bbox 数値

Featuresオブジェクト

名称 レスポンス名 型名 配列 説明
種別 type 文字列 "Feature"固定
形状全体のバウンディングボックス bbox 数値
形状の緯度経度情報 geometry Geometryオブジェクト 形状の緯度経度情報
形状のメタ情報 properties Propertyオブジェクト 形状のメタ情報

Geometryオブジェクト

名称 レスポンス名 型名 配列 説明
種別 type 文字列 "LineString"固定
緯度経度 coordinate Coordinateオブジェクト

Coordinateオブジェクト

名称 レスポンス名 型名 配列 説明
緯度 lat 数値
経度 lon 数値

Propertyオブジェクト

名称 レスポンス名 型名 配列 説明
路線ID link 文字列
路線色 color 文字列 路線色を表すカラーコード

レスポンス例

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "bbox": [
        139.619445,
        35.699367,
        139.635774,
        35.704395
      ],
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            139.619445,
            35.704204
          ],
          ・・・
          [
            139.635774,
            35.699367
          ]
        ]
      },
      "properties": {
        "color": "#F62E36",
        "link": "00000766"
      }
    },
    ・・・
    {
      "type": "Feature",
      "bbox": [
        139.711766,
        35.725796,
        139.729911,
        35.730751
      ],
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            139.729911,
            35.725796
          ],
          ・・・
          [
            139.711766,
            35.730238
          ]
        ]
      },
      "properties": {
        "color": "#F62E36",
        "link": "00000766"
      }
    },
    {
      "type": "Feature",
      "bbox": [
        139.658234,
        35.68362,
        139.667213,
        35.690676
      ],
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            139.658234,
            35.68362
          ],
          ・・・
          [
            139.667213,
            35.690676
          ]
        ]
      },
      "properties": {
        "_order": 24,
        "order": 0,
        "route": 18743360,
        "link_color": "#F62E36",
        "link_id": "00000767"
      }
    },
    ・・・
  ]
   "bbox": [
    139.619445,
    35.672249,
    139.767541,
    35.730751
  ]
}