Récupérer les détections

GET https://contrails.googleapis.com/v2/detections: obtenir les détections de traînées de condensation au format GeoJSON LineString.

Si la requête aboutit, la réponse sera une FeatureCollection au format GeoJSON. Notez qu'il est possible de renvoyer une FeatureCollection vide si la période est hors champ (par exemple, si vous recherchez des traînées de condensation détectées à l'avenir). De plus, la cohérence des détections n'est pas garantie, car les modèles de détection sont mis à jour et les données sont complétées.

Paramètres de requête

Paramètres
start_time

string

Obligatoire. Heure de début de la requête.

Format : chaîne de date et heure ISO 8601

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

string

Obligatoire. Heure de fin de la requête (incluse). Notez que end_time ne peut pas dépasser start_time de plus de 24 heures.

Format : chaîne de date et heure ISO 8601

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

string

Facultatif. Les valeurs valides sont GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK et MTG-000-FULL-DISK, qui représentent respectivement les satellites GOES_EAST, Himawari et MTG.

Si ce paramètre est fourni, ce point de terminaison ne renverra que les traînées de condensation détectées par les satellites spécifiés dans satellite_origins.

S'il n'est pas fourni, il renvoie les traînées de condensation détectées par tous les fournisseurs de données satellite applicables.

Format : tableau de chaînes

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

Exemples

  • Pour récupérer toutes les détections de traînées de condensation à un moment précis :

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

  • Pour récupérer les détections de traînées de condensation à un moment précis, limitées aux détections 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},
)

    ou en 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"

Voici un exemple de réponse réussie avec des traînées de condensation détectées :

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