감지 결과 가져오기

GET https://contrails.googleapis.com/v2/detections: GeoJSON LineString 형식으로 비행운 감지를 가져옵니다.

성공하면 응답은 GeoJSON 형식의 FeatureCollection이 됩니다. 시간 범위가 범위를 벗어나는 경우 (예: 미래에 감지된 비행운 검색) 빈 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"]

예

  • 특정 시점의 모든 비행운 감지를 검색하려면 다음을 실행합니다.

    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},
)

  • 특정 시점의 비행운 감지를 검색하려면 Himawari 감지로 제한합니다.

    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.sandbox.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"

감지된 비행운이 포함된 성공 응답은 다음과 같이 표시됩니다.

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            90.06765747070312,
            44.201324462890625
          ],
          [
            90.99974060058594,
            43.65225601196289
          ]
        ]
      },
      "properties": {
        "time": "2026-03-10T00: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-03-10T00:00:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    }
  ]
}