Mengambil deteksi

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

Jika berhasil, responsnya akan berupa FeatureCollection dalam format GeoJSON.

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

Mengirim kueri deteksi dengan rentang waktu yang di luar cakupan, seperti waktu yang ditentukan di masa mendatang, akan menampilkan FeatureCollection kosong.

Parameter kueri

Parameter
start_time

string

Wajib. Waktu mulai permintaan.

Format: String tanggal dan waktu 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 tanggal dan waktu 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 ada, endpoint ini hanya akan menampilkan jejak pesawat yang terdeteksi dari satelit yang ditentukan dalam satellite_origins.

Jika tidak ada, akan menampilkan jejak pesawat 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 "latitude,longitude", 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 jejak pesawat yang terdeteksi yang berpotongan dengan bagian mana pun dari poligon pembatas.

Jika tidak ada, akan menampilkan jejak pesawat 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 jejak pesawat 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 jejak pesawat 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 jejak pesawat untuk jangka waktu tertentu, terbatas pada 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 jejak pesawat 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"
      }
    }
  ]
}