Récupérer les détections

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

En cas de réussite, la réponse sera un FeatureCollection au format GeoJSON.

Les coordonnées renvoyées correspondent à la longitude et à la latitude des points de terminaison de la détection linéarisée, projetées sur la surface de la Terre du point de vue du satellite. Pour les détections GOES, les coordonnées renvoyées incluent également, de manière facultative, des valeurs d'altitude spéculatives.

Si vous interrogez des détections avec une plage temporelle hors champ, par exemple une heure spécifiée dans le futur, une FeatureCollection vide est renvoyée.

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.

Lorsqu'il est présent, ce point de terminaison ne renvoie que les traînées de condensation détectées par les satellites spécifiés dans satellite_origins.

Lorsqu'il n'est pas présent, 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"]
bounds[]

string

Facultatif. Liste de paires de chaînes, chacune devant être au format "latitude,longitude", spécifiant les sommets d'un polygone de délimitation.

Si ce paramètre est présent, au moins trois bounds doivent être spécifiés. Les limites doivent former un polygone valide (par exemple, sans sommets en double ni auto-intersection).

Lorsqu'il est présent, ce point de terminaison ne renvoie que les traînées de condensation détectées qui croisent une partie du polygone de délimitation.

Lorsqu'il n'est pas présent, il renvoie les traînées de condensation détectées, quel que soit leur emplacement.

Format : tableau de chaînes

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

Exemples

  • Pour récupérer toutes les détections de traînées de condensation pour une période spécifique :

    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 toutes les détections de traînées de condensation pour une période spécifique, limitées par un polygone de délimitation :

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

  • Pour récupérer les détections de traînées de condensation pour une période spécifique, 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.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 réponse GeoJSON à cette requête répertorie les données de détection des traînées de condensation des satellites Himawari pour la plage temporelle demandée :

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