飛行機、航空分野を楽しむブログ

１．All State Vectors（全状態ベクトル）とは

All State Vectors（オール ステート ベクターズ、全状態ベクトル）はOpenSky REST APIの1つのエンドポイントです。
全世界又は指定したエリアの航空機データを取得します。

※なぜ「State Vector（ステート ベクター）」と呼ぶのか？
航空用語における「ステート（状態）」とは、ある特定の瞬間における航空機の位置、速度、高度などの物理的なパラメータのセットを指します。
これらが一列のデータ（ベクトル）として並んでいるため、OpenSkyではこれを State Vector と呼んでいます。

２．機能

このエンドポイントは、全世界又は指定したエリアの航空機データをJSON形式で返します。
データは数秒ごとに更新されます。

• 認証あり: OpenSkyアカウントでログインして利用（より高い頻度でリクエスト可能）。
• 認証なし: 誰でも利用可能（ただし、リクエスト頻度やデータ鮮度に制限あり）。

※エンドポイント
エンドポイントとは、Web APIにおいてサーバー上の特定データや機能にアクセスするための「入り口となる具体的なURL（URL）」です。

３．オペレーション

GET /states/all

４．リクエスト

特定の飛行機や時刻に対して、以下のリクエストパラメータを使って状態ベクトルを(任意で)リクエストできます。

さらに、WGS84座標（GPSやGoogleマップ、国際的な地図・ナビゲーションで標準的に使用される地心座標系）のバウンディングボックス（境界ボックス、四角形の境界で定義された特定の領域）に限定したデータを取得することも可能です。

最後に、航空機のカテゴリー情報をリクエストできます。
カテゴリーは、大型機、小型機、ヘリコプターなどです。
このパラメーターは、デフォルト（指定しない場合）では false の状態になっています。

５．レスポンス

応答は以下のプロパティを持つJSONオブジェクトです。

状態ベクトルは二次元配列です。各行は状態ベクトルを表します。詳細は以下の通りです。

６．プログラム例（Python）

Pythonによるプログラム例を示します。
特定のエリア（東京近郊）の航空機データを取得するプログラム例です。

import requests

# 東京近郊の範囲を指定
params = {
    'lamin': 34.0,
    'lomin': 138.5,
    'lamax': 36.0,
    'lomax': 140.5
}

url = "https://opensky-network.org/api/states/all"
response = requests.get(url, params=params)

if response.status_code == 200:
    data = response.json()
    for flight in data['states']:
        print(f"コールサイン: {flight[1]}, 登録国: {flight[2]}, 高度: {flight[7]}m, スコーク: {flight[14]}")

import requests

# 東京近郊の範囲を指定
params = {
    'lamin': 34.0,
    'lomin': 138.5,
    'lamax': 36.0,
    'lomax': 140.5
}

url = "https://opensky-network.org/api/states/all"
response = requests.get(url, params=params)

if response.status_code == 200:
    data = response.json()
    for flight in data['states']:
        print(f"コールサイン: {flight[1]}, 登録国: {flight[2]}, 高度: {flight[7]}m, スコーク: {flight[14]}")

出力例

引用：The OpenSky Network API documentation
https://openskynetwork.github.io/opensky-api/rest.html#all-state-vectors