Mengambil deteksi

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

Jika berhasil, responsnya akan berupa FeatureCollection dalam format GeoJSON. Perhatikan bahwa FeatureCollection kosong dapat ditampilkan jika rentang waktu berada di luar cakupan (misalnya, menelusuri jejak kondensasi yang terdeteksi di masa mendatang). Selain itu, deteksi tidak dijamin konsisten karena model deteksi diperbarui dan data diisi ulang.

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-EAST-FULL-DISK, HIMAWARI-FULL-DISK, dan MTG-000-FULL-DISK, yang masing-masing mewakili satelit GOES_EAST, Himawari, dan MTG. Jika diberikan, endpoint ini hanya akan menampilkan jejak kondensasi yang terdeteksi dari satelit yang ditentukan dalam satellite_origins. Jika tidak diberikan, endpoint ini akan menampilkan jejak kondensasi yang terdeteksi dari semua penyedia data satelit yang berlaku. Format: Array string Contoh: ["GOES-EAST-FULL-DISK", "HIMAWARI-FULL-DISK"]

Contoh

• Untuk mengambil semua deteksi jejak kondensasi untuk titik 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 deteksi jejak kondensasi untuk titik 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.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"
  

Respons yang berhasil dengan jejak kondensasi yang terdeteksi akan terlihat seperti ini:

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