検出マスクを取得する

GET https://contrails.googleapis.com/v2/detections/masks: NetCDF4 形式の飛行機雲検出マスクを取得します。

成功すると、レスポンスは飛行機雲検出マスクの NetCDF になります。 必要に応じて、スキャン時間オフセットをレスポンスに含めることもできます。

クエリ パラメータ

パラメータ
start_time

string

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

形式: ISO 8601 日時文字列

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

string

必須。リクエストの終了時間（指定時間を含む）。end_time は start_time より 1 時間以上長くすることはできません。

形式: ISO 8601 日時文字列

例: 2026-01-20T22:00:00Z
satellite_origin

string

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

形式: 文字列

例: "GOES-EAST-FULL-DISK"
view

DetectionMaskView

省略可。デフォルトは DETECTION_MASK_VIEW_UNSPECIFIED です。DETECTION_MASK_VIEW_FULL の場合、レスポンスにフルディスク衛星オフセット（秒単位）が含まれます。

形式: ドキュメントを参照

例: DETECTION_MASK_VIEW_BASIC

例

  • スキャン時間オフセットを使用して、特定の時点の衛星から検出マスクを取得するには:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/detections/masks",
  params={"start_time": "2026-04-10T00:00:00Z",
          "end_time": "2026-04-10T01:00:00Z",
          "satellite_origin": "MTG-000-FULL-DISK"
          "view": "DETECTION_MASK_VIEW_FULL"},
  headers={"x-goog-api-key": API_KEY},
)

    または CURL で:

    curl "https://contrails.googleapis.com/v2/detections/masks?\
key=API_KEY&\
start_time=2026-04-10T00:00:00Z&\
end_time=2026-04-10T01:00:00Z&\
satellite_origin=MTG-000-FULL-DISK&\
view=DETECTION_MASK_VIEW_FULL"

    xarray で読み込むと、このリクエストは次のデータセットを返します。

    ディメンション: (時間: 6、y: 5568、x: 5568)
    座標
    名前 ディメンション データ型 値
    時間 (時間) datetime64[ns] 2026-04-10T00:00:07 ... 2026-04-10T00:50:07
    y (y) float32 5.569e+06 5.567e+06 ... -5.569e+06
    x (x) float32 -5.569e+06 -5.567e+06 ... 5.569e+06
    データ変数
    マスク (時間、y、x) float32 0.0 0.0 0.0 0.0 ... 0.0 ...
    scantime_offset (時間、y、x) float64 nan nan nan nan ... 564. 568. ...
    projection () DataArray +proj=geos +lon_0=0 +h=35786400 +x_0=0 +y_0=0 +a=6378137 +b=6356752.3 +units=m +no_defs

    `projection` は、 pyproj.Proj オブジェクトの文字列形式でフォーマットされます。

    projection を使用すると、地図の x 座標と y 座標を緯度と経度の座標に変換できます。

DetectionMaskView

検出マスクに対して返される詳細レベルを定義します。

列挙型
DETECTION_MASK_VIEW_UNSPECIFIED ビューが指定されていません。実際には、これは BASIC として扱われます。
DETECTION_MASK_VIEW_BASIC 検出マスクの値と衛星投影データが含まれます。
DETECTION_MASK_VIEW_FULL 検出マスクの値、衛星投影データ、フルディスク スキャン時間オフセットが含まれます。