감지 마스크 가져오기

GET https://contrails.googleapis.com/v2/detections/masks: NetCDF4 형식으로 비행운 감지 마스크를 가져옵니다.

성공한 경우 응답은 비행운 감지 마스크의 NetCDF가 됩니다. 선택적으로 scantime 오프셋도 응답에 포함될 수 있습니다.

쿼리 매개변수

매개변수
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

예

  • scantime 오프셋이 있는 특정 시점에 위성에서 감지 마스크를 검색하려면 다음을 실행합니다.

    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. ...
    프로젝션 () 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 감지 마스크 값, 위성 프로젝션 데이터, 전체 디스크 scantime 오프셋이 포함됩니다.