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à un FeatureCollection in formato GeoJSON.

Le coordinate restituite sono la longitudine e la latitudine degli endpoint del rilevamento linearizzato, proiettate sulla superficie terrestre dal punto di vista del satellite. Per i rilevamenti GOES, le coordinate restituite includono anche, facoltativamente, i valori di altitudine stimati.

L'esecuzione di query sui rilevamenti con un intervallo di tempo fuori ambito, ad esempio un'ora specificata futura, restituisce un FeatureCollection vuoto.

Parametri di query

Parametri
start_time

string

Obbligatorio. Ora di inizio della richiesta.

Formato: stringa di data e ora 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 di data e ora ISO 8601

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

string

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

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

Se non è presente, 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"]
bounds[]

string

Facoltativo. Un elenco di coppie di stringhe, ognuna delle quali deve essere nel formato "latitudine,longitudine", che specifica i vertici di un poligono di delimitazione.

Se presente, devono essere specificati almeno tre bounds. I limiti devono formare un poligono valido (ad es. nessun vertice duplicato, nessuna autointersezione)

Se presente, questo endpoint restituirà solo le scie di condensazione rilevate che intersecano una qualsiasi parte del poligono di delimitazione.

Se non è presente, restituisce le scie di condensazione rilevate indipendentemente dalla località.

Formato: array di stringhe

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

Esempi

  • Per recuperare tutti i rilevamenti di scie di condensazione per una finestra di tempo specifica:

    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 tutti i rilevamenti di scie di condensazione per una finestra di tempo specifica, limitata dal poligono di delimitazione:

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

  • Per recuperare i rilevamenti di scie di condensazione per una finestra di tempo specifica, limitata ai rilevamenti 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.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"

    La risposta GeoJSON per questa richiesta elenca i dati di rilevamento delle scie di condensazione dei satelliti Himawari per l'intervallo di tempo richiesto:

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