Mengambil wilayah perkiraan

GET https://contrails.googleapis.com/v2/regions: Mendapatkan wilayah penghindaran jejak pesawat dalam format multipoligon GeoJSON.

Jika berhasil, responsnya akan berupa FeatureCollection dalam format GeoJSON.

Wilayah penghindaran jejak pesawat yang ditampilkan dalam format poligon diberi peringkat berdasarkan tingkat keparahan, mulai dari 1 hingga 4 untuk setiap tingkat penerbangan. Makin tinggi nilainya, makin parah jejak pesawatnya.

Parameter kueri

Parameter
time

string

Wajib. Waktu permintaan.

Format: String tanggal dan waktu ISO 8601 ATAU bilangan bulat epoch Unix

Contoh: 2026-01-20T21:00:00Z
flightLevel[]

integer

Opsional. Tingkat penerbangan yang akan ditampilkan. Jika tidak ada tingkat penerbangan yang ditentukan, semua tingkat penerbangan akan disertakan.

Format: Level penerbangan dalam hectofeet; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440]

Contoh: [270, 280, 290, 300]
threshold

integer

Opsional. Nilai minimum tingkat keparahan. Menetapkan kolom ini hanya akan menampilkan region dengan tingkat keparahan lebih besar dari atau sama dengan nilai minimum.

Format: Nilai valid berkisar dari 1 hingga 4 (inklusif).
aircraftClass

string

Opsional. Kelas pesawat. Saat ini, hanya default yang didukung.

Contoh

  • Untuk mengambil semua wilayah penghindaran jejak pesawat pada titik waktu tertentu:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={"time": 2026-01-27T12:00:00Z},
  headers={"x-goog-api-key": API_KEY},
)

    Respons GeoJSON mencantumkan semua wilayah penghindaran jejak pesawat dalam format poligon:

    geometri flight_level nilai minimum waktu forecast_reference_time aircraft_class
    0 MULTIPOLYGON Z (((166.25 81.12 8229.6, 168.37 ... 270 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 default
    1 MULTIPOLYGON Z (((92.38 45.5 8229.6, 93 46.62 ... 270 2 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 default
    2 MULTIPOLYGON Z (((83.38 65 8229.6, 84 66.12 82... 270 3 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 default
    3 MULTIPOLYGON Z (((57.38 76 8229.6, 57.75 76.88... 270 4 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 default
    4 MULTIPOLYGON Z (((162.38 79 8534.4, 162.75 79.... 280 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 default

  • Untuk mengambil wilayah penghindaran jejak pesawat yang dibatasi pada tingkat penerbangan tertentu, dengan waktu yang ditentukan sebagai bilangan bulat epoch Unix:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 1768942800,
    "flightLevel": [300,310,320,330]
  },
  headers={"x-goog-api-key": API_KEY},
)

  • Untuk mengambil wilayah penghindaran jejak pesawat yang terbatas pada tingkat penerbangan tertentu dan sama dengan atau di atas nilai minimum tingkat keparahan 3:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 2026-01-27T12:00:00Z,
    "flightLevel": [300,310,320,330],
    "threshold": 3
  },
  headers={"x-goog-api-key": API_KEY},
)