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.

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

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

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-WEST-FULL-DISK, 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 extremo solo mostrará las estelas de condensación detectadas de los satélites especificados en satellite_origins.

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

string

Es 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 autointersección).

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

Cuando no está presente, muestra 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 para 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 delimitador, 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 para un período específico, limitado 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 GeoJSON para esta solicitud muestra 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"
      }
    }
  ]
}