Mengambil deteksi

GET https://contrails.googleapis.com/v2/detections: Mendapatkan deteksi contrail dalam format GeoJSON LineString.

Jika berhasil, responsnya akan berupa FeatureCollection dalam format GeoJSON.

Koordinat yang ditampilkan adalah bujur dan lintang endpoint deteksi yang dilinearisasi, diproyeksikan ke permukaan bumi dari perspektif satelit. Untuk deteksi GOES, koordinat yang ditampilkan juga secara opsional menyertakan nilai ketinggian yang diperkirakan.

Mengkueri deteksi dengan rentang waktu yang berada di luar cakupan, seperti waktu tertentu yang berada di masa mendatang, akan menampilkan FeatureCollection kosong.

Parameter kueri

Parameter
start_time

string

Wajib. Waktu mulai permintaan.

Format: String datetime ISO 8601

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

string

Wajib. Waktu berakhir permintaan (inklusif). Perhatikan bahwa end_time tidak boleh melebihi start_time lebih dari 24 jam.

Format: String datetime ISO 8601

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

string

Opsional. Nilai yang valid adalah GOES-WEST-FULL-DISK, GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK, dan MTG-000-FULL-DISK, yang masing-masing mewakili satelit GOES_EAST, Himawari, dan MTG.

Jika ada, endpoint ini hanya akan menampilkan contrail yang terdeteksi dari satelit yang ditentukan dalam satellite_origins.

Jika tidak ada, akan menampilkan contrail yang terdeteksi dari semua penyedia data satelit yang berlaku.

Format: array string

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

string

Opsional. Daftar pasangan string, yang masing-masing harus dalam format "lintang,bujur", yang menentukan verteks untuk poligon pembatas.

Jika ada, setidaknya tiga bounds harus ditentukan. Batas harus membentuk poligon yang valid (misalnya, tidak ada verteks duplikat, tidak ada persimpangan sendiri)

Jika ada, endpoint ini hanya akan menampilkan contrail yang terdeteksi yang berpotongan dengan bagian mana pun dari poligon pembatas.

Jika tidak ada, akan menampilkan contrail yang terdeteksi, terlepas dari lokasinya.

Format: array string

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

Contoh

  • Untuk mengambil semua deteksi contrail untuk jangka waktu tertentu:

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

  • Untuk mengambil semua deteksi contrail untuk jangka waktu tertentu, yang dibatasi oleh poligon pembatas:

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

  • Untuk mengambil deteksi contrail untuk jangka waktu tertentu, yang dibatasi untuk deteksi 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},
)

    atau di 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"

    Respons GeoJSON untuk permintaan ini mencantumkan data deteksi contrail dari satelit Himawari untuk rentang waktu yang diminta:

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