Cómo recuperar detecciones

GET https://contrails.googleapis.com/v2/detections: Obtén detecciones de estelas de condensación en formato GeoJSON LineString.

Si la solicitud se realiza correctamente, la respuesta será un FeatureCollection en formato GeoJSON. Ten en cuenta que es posible mostrar un FeatureCollection vacío si el período está fuera del alcance (p.ej., si buscas estelas de condensación detectadas en el futuro). Además, no se garantiza que las detecciones sean coherentes, ya que los modelos de detección se actualizan y los datos se vuelven a completar.

Parámetros de consulta

Parámetros
start_time

string

Obligatorio. Hora de inicio de la solicitud.

Formato: cadena de fecha y hora ISO 8601

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

string

Obligatorio. Hora de finalización de la solicitud (inclusive). Ten en cuenta que end_time no puede exceder start_time en más de 24 horas.

Formato: cadena de fecha y hora ISO 8601

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

string

Es opcional. Los valores válidos son GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK y MTG-000-FULL-DISK, que representan los satélites GOES_EAST, Himawari y MTG, respectivamente.

Si se proporciona, este extremo solo mostrará las estelas de condensación detectadas de los satélites especificados en satellite_origins.

Si no se proporciona, muestra las estelas de condensación detectadas de todos los proveedores de datos satelitales aplicables.

Formato: array de cadenas

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

Ejemplos

  • Para recuperar todas las detecciones de estelas de condensación para un momento específico, haz lo siguiente:

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

  • Para recuperar las detecciones de estelas de condensación para un momento específico, limitadas a las detecciones de Himawari, haz lo siguiente:

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

Una respuesta correcta con estelas de condensación detectadas se verá de la siguiente manera:

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