検出を取得する

GET https://contrails.googleapis.com/v2/detections: GeoJSON LineString 形式で飛行機雲の検出を取得します。

成功すると、レスポンスは GeoJSON 形式の FeatureCollection になります。

返される座標は、線形化された検出の端点の経度と緯度で、衛星の視点から地球の表面に投影されます。GOES 検出の場合、返される座標には、推定された高度の値もオプションで含まれます。

範囲外の時間（将来の指定時間など）で検出をクエリすると、空の FeatureCollection が返されます。

クエリ パラメータ

パラメータ
start_time

string

必須。リクエストの開始時間。

形式: ISO 8601 日時文字列

例: 2026-01-20T21:00:00Z
end_time

string

必須。リクエストの終了時刻（指定した時刻も期間に含む）。end_time は start_time を 24 時間以上超えることはできません。

形式: ISO 8601 日時文字列

例: 2026-01-20T22:00:00Z
satellite_origins[]

string

省略可。有効な値は GOES-EAST-FULL-DISK、HIMAWARI-FULL-DISK、MTG-000-FULL-DISK で、それぞれ GOES_EAST、Himawari、MTG 衛星を表します。

このエンドポイントが存在する場合、satellite_origins 内で指定された衛星から検出された飛行機雲のみが返されます。

指定しない場合、該当するすべての衛星データ プロバイダから検出された飛行機雲が返されます。

形式: 文字列配列

例: ["GOES-EAST-FULL-DISK", "HIMAWARI-FULL-DISK"]
bounds[]

string

省略可。文字列ペアのリスト。各ペアは「緯度,経度」形式で指定する必要があります。境界ポリゴンの頂点を指定します。

指定する場合は、少なくとも 3 つの bounds を指定する必要があります。境界は有効なポリゴンを形成する必要があります（重複する頂点や自己交差がないなど）。

このエンドポイントが存在する場合、境界ポリゴンのいずれかの部分と交差する検出された飛行機雲のみが返されます。

存在しない場合は、場所に関係なく検出された飛行機雲を返します。

形式: 文字列配列

例: ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]

例

  • 特定の期間のすべての飛行機雲検出を取得するには:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/detections",
  params={"start_time": "2026-01-27T12:00:00Z",
          "end_time": "2026-01-27T12:10:00Z"},
  headers={"x-goog-api-key": API_KEY},
)

  • 特定の期間のすべての飛行機雲検出を取得するには（境界ポリゴンで制限されます）:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/detections",
  params={"start_time": "2026-01-27T12:00:00Z",
          "end_time": "2026-01-27T12:10:00Z",
          "bounds": ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]},
  headers={"x-goog-api-key": API_KEY},
)

  • 特定の期間の飛行機雲検出を取得するには（ひまわり検出に限定）:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/detections",
  params={"start_time": "2026-01-27T12:00:00Z",
          "end_time": "2026-01-27T12:10:00Z",
          "satellite_origins": ["HIMAWARI-FULL-DISK"]},
  headers={"x-goog-api-key": API_KEY},
)

    または CURL で次のようにします。

    curl "https://contrails.googleapis.com/v2/detections?\
key=API_KEY&\
start_time=2026-01-27T12:00:00Z&\
end_time=2026-01-27T12:10:00Z&\
satellite_origins=HIMAWARI-FULL-DISK"

    このリクエストに対する GeoJSON レスポンスには、リクエストされた期間のひまわり衛星からの飛行機雲検出データがリストされます。

    {
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            90.06765747070312,
            44.201324462890625
          ],
          [
            90.99974060058594,
            43.65225601196289
          ]
        ]
      },
      "properties": {
        "time": "2026-01-27T12:00:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            105.36386108398438,
            -1.7198446989059448
          ],
          [
            105.7318115234375,
            -2.5787696838378906
          ]
        ]
      },
      "properties": {
        "time": "2026-01-27T12:10:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    }
  ]
}