감지 결과 가져오기

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

성공하면 응답은 GeoJSON 형식의 FeatureCollection입니다.

반환된 좌표는 선형화된 감지의 엔드포인트의 경도와 위도이며, 위성 관점에서 지구 표면에 투영됩니다. GOES 감지의 경우 반환된 좌표에 추측된 고도 값이 선택적으로 포함될 수도 있습니다.

범위를 벗어난 시간 범위(예: 미래의 지정된 시간)로 감지 항목을 쿼리하면 빈 FeatureCollection이 반환됩니다.

쿼리 매개변수

매개변수
start_time

string

필수 항목입니다. 요청 시작 시간입니다.

형식: ISO 8601 datetime 문자열

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

string

필수 항목입니다. 요청의 종료 시간 (포함)입니다. end_time은 start_time보다 24시간 이상 초과할 수 없습니다.

형식: ISO 8601 datetime 문자열

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

string

선택사항입니다. 유효한 값은 각각 GOES_EAST, Himawari, MTG 위성을 나타내는 GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK, MTG-000-FULL-DISK입니다.

이 엔드포인트는 있는 경우 satellite_origins 내에 지정된 위성에서 감지된 비행운만 반환합니다.

제공되지 않으면 적용 가능한 모든 위성 데이터 제공업체에서 감지된 비행운을 반환합니다.

형식: 문자열 배열

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

string

선택사항입니다. 각각 '위도,경도' 형식이어야 하며 경계 다각형의 꼭짓점을 지정하는 문자열 쌍의 목록입니다.

있는 경우 bounds를 3개 이상 지정해야 합니다. 경계는 유효한 다각형을 형성해야 합니다 (예: 중복된 꼭짓점 없음, 자체 교차 없음).

이 엔드포인트가 있으면 경계 다각형의 일부와 교차하는 감지된 비행운만 반환합니다.

위치가 없으면 위치와 관계없이 감지된 비행기 구름을 반환합니다.

형식: 문자열 배열

예: ["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},
)

  • 특정 시간대의 비행운 감지를 가져오려면 다음을 사용하세요. 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.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 응답에는 요청된 시간 범위에 대한 Himawari 위성의 비행운 감지 데이터가 나열됩니다.

    {
  "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"
      }
    }
  ]
}