Recuperare i rilevamenti

GET https://contrails.googleapis.com/v2/detections: recupera i rilevamenti di scie di condensazione nel formato GeoJSON LineString.

In caso di esito positivo, la risposta sarà una FeatureCollection in formato GeoJSON. Tieni presente che è possibile restituire una FeatureCollection vuota se l'intervallo di tempo non è compreso nell'ambito (ad es. se cerchi scie di condensazione rilevate in futuro). Inoltre, non è garantita la coerenza dei rilevamenti, poiché i modelli di rilevamento vengono aggiornati e i dati vengono sottoposti a backfill.

Parametri di query

Parametri
start_time

string

Obbligatorio. Ora di inizio della richiesta.

Formato: stringa datetime ISO 8601

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

string

Obbligatorio. Ora di fine della richiesta (inclusa). Tieni presente che end_time non può superare start_time di più di 24 ore.

Formato: stringa datetime ISO 8601

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

string

Facoltativo. I valori validi sono GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK e MTG-000-FULL-DISK, che rappresentano rispettivamente i satelliti GOES_EAST, Himawari e MTG.

Se fornito, questo endpoint restituirà solo le scie di condensazione rilevate dai satelliti specificati in satellite_origins.

Se non viene fornito, restituisce le scie di condensazione rilevate da tutti i fornitori di dati satellitari applicabili.

Formato: array di stringhe

Esempio: ["GOES-EAST-FULL-DISK", "HIMAWARI-FULL-DISK"]

Esempi

  • Per recuperare tutti i rilevamenti di scie di condensazione per un punto specifico nel tempo:

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

  • Per recuperare i rilevamenti di scie di condensazione per un punto specifico nel tempo, limitati ai rilevamenti di 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},
)

    oppure in 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"

Una risposta corretta con le scie di condensazione rilevate sarà simile alla seguente:

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