Recuperare i rilevamenti

GET https://contrails.googleapis.com/v2/detections: Ottieni i rilevamenti di scie 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 dei punti finali del rilevamento linearizzato, proiettate sulla superficie terrestre dal punto di vista del satellite. Per i rilevamenti GOES, le coordinate restituite includono anche, facoltativamente, valori di altitudine ipotizzati.

L'interrogazione dei rilevamenti con un intervallo di tempo non incluso nell'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-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, è necessario specificare 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 qualsiasi parte del poligono di delimitazione.

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

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 un periodo di tempo specifico:

    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 un intervallo di tempo specifico, limitato da un 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 un intervallo di tempo specifico, limitato 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},
)

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