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 operación se realiza correctamente, la respuesta será un FeatureCollection en formato GeoJSON.

Las coordenadas devueltas son la longitud y la latitud de los extremos de la detección linealizada, proyectadas sobre la superficie de la Tierra desde la perspectiva del satélite. En el caso de las detecciones de GOES, las coordenadas devueltas también incluyen, de forma opcional, valores de altitud especulados.

Si se consultan detecciones con un período que está fuera del alcance, como una hora especificada que es futura, se devuelve un FeatureCollection vacío.

Parámetros de consulta

Parámetros
start_time

string

Obligatorio. Es la 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 superar 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

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.

Cuando está presente, este endpoint solo devolverá las estelas de condensación detectadas desde los satélites especificados en satellite_origins.

Cuando no está presente, devuelve 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"]
bounds[]

string

Opcional. Es una lista de pares de cadenas, cada uno de los cuales debe estar en formato "latitud,longitud", que especifica los vértices de un polígono delimitador.

Si está presente, se deben especificar al menos tres bounds. Los límites deben formar un polígono válido (p. ej., sin vértices duplicados ni intersecciones).

Cuando está presente, este extremo solo devolverá las estelas de condensación detectadas que se intersecan con cualquier parte del polígono delimitador.

Cuando no está presente, devuelve las estelas de condensación detectadas independientemente de la ubicación.

Formato: array de cadenas

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

Ejemplos

  • Para recuperar todas las detecciones de estelas de condensación en un período 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 todas las detecciones de estelas de condensación para un período específico, limitado por un polígono de límite, 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",
          "bounds": ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]},
  headers={"x-goog-api-key": API_KEY},
)

  • Para recuperar las detecciones de estelas de condensación en un período 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.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 respuesta de GeoJSON para esta solicitud enumera los datos de detección de estelas de condensación de los satélites Himawari para el período solicitado:

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