会社情報

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.

会社の情報を取得します。 oldNameに会社の旧名称を指定すると、新名称を取得できます。会社の分類は「バス会社」と「バス会社以外の会社」の二つです。

GET /v1/{format}/corporation

parameters

Name	Type	Description
format	string	レスポンスのデータ形式の指定。必須指定できる値: - xml: xml形式のデータ - json: json形式のデータ ※クエリパラメータではなくパスに値を指定します。
key	string	アクセスキー。必須
code	int	会社コード。コードが振られているのは鉄道会社のみです。prefectureCode, type, oldNameと排他。省略可。
name	string	会社の名称（前方一致）。code, oldNameと排他。省略可。
prefectureCode	int	都道府県コード。oldName指定時無効です。複数指定可。省略可。省略時は全ての都道府県を対象とします。
type	string	会社の種別を指定します。oldName指定時無効。省略可。省略時は全ての会社を対象とします。指定できる値: - bus: バス会社 - train: バス会社以外の会社
oldName	string	会社の旧名称。prefectureCode, typeと排他。 ※路線バス会社名は旧名称に対応していません。
offset	int	データの取得開始位置。oldName指定時無効です。省略可 Default: 1
limit	int	データのブロック件数。oldName指定時無効です。指定可能な値は1から100です。省略可 Default: 100

response

Name	Description
ResultSet	レスポンスの最下部を表す要素
ResultSet / apiVersion	WebAPIバージョン
ResultSet / engineVersion	エンジンバージョン
ResultSet / max	データの取得件数。一度に全件取得できない場合は、offsetの指定を繰り上げて取得してください。
ResultSet / offset	データ開始位置のオフセット値
ResultSet / Corporation	会社を表す要素
ResultSet / Corporation / code	会社コード
ResultSet / Corporation / Name	会社の名称を表す要素
ResultSet / Corporation / OldName	会社の旧名称を表す要素 ※oldNameを指定した場合のみ出現
ResultSet / Corporation / Type	交通種別を表す要素
ResultSet / Corporation / Type / detail	交通種別の詳細。複数存在する場合は`:`区切りの文字列で表現します。

example

GET /v1/xml/corporation?key=アクセスキーを入力してください&prefectureCode=1

<ResultSet apiVersion="1.27.0.0" max="22" offset="1" engineVersion="201608_03a">
  <Corporation code="1">
    <Name>ＪＲ</Name>
    <Type>train</Type>
  </Corporation>
  <Corporation code="30">
    <Name>札幌市交通局</Name>
    <Type>train</Type>
  </Corporation>
  <Corporation code="221">
    <Name>道南いさりび鉄道</Name>
    <Type>train</Type>
  </Corporation>
  <Corporation code="31">
    <Name>函館市企業局交通部</Name>
    <Type>train</Type>
  </Corporation>
  <Corporation code="8">
    <Name>航空会社</Name>
    <Type>plane</Type>
  </Corporation>
  <Corporation>
    <Name>航海会社</Name>
    <Type>ship</Type>
  </Corporation>
  :
  </Corporation>
</ResultSet>

GET /v1/json/corporation?key=アクセスキーを入力してください&prefectureCode=1

{
  "ResultSet": {
    "apiVersion": "1.27.0.0",
    "max": "22",
    "offset": "1",
    "engineVersion": "201608_03a",
    "Corporation": [
      {
        "code": "1",
        "Name": "ＪＲ",
        "Type": "train"
      },
      {
        "code": "30",
        "Name": "札幌市交通局",
        "Type": "train"
      },
      {
        "code": "221",
        "Name": "道南いさりび鉄道",
        "Type": "train"
      },
      {
        "code": "31",
        "Name": "函館市企業局交通部",
        "Type": "train"
      },
      {
        "code": "8",
        "Name": "航空会社",
        "Type": "plane"
      },
      {
        "Name": "航海会社",
        "Type": "ship"
      },
      {
        :
      }
    ]
  }
}