Cómo recuperar máscaras de detección

GET https://contrails.googleapis.com/v2/detections/masks: Obtén máscaras de detección de estelas de condensación en formato NetCDF4.

Si la solicitud se realiza correctamente, la respuesta será un archivo NetCDF de máscaras de detección de estelas de condensación.

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 superar start_time en más de 1 hora.

Formato: Cadena de fecha y hora ISO 8601

Ejemplo: 2026-01-20T22:00:00Z
satellite_origin

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.

Formato: Cadena

Ejemplo: "GOES-EAST-FULL-DISK"

Ejemplos

  • Para recuperar máscaras de detección de un satélite para un punto específico en el tiempo, haz lo siguiente:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/detections/masks",
  params={"start_time": "2026-04-10T00:00:00Z",
          "end_time": "2026-04-10T01:00:00Z",
          "satellite_origin": "MTG-000-FULL-DISK"},
  headers={"x-goog-api-key": API_KEY},
)

    o en CURL:

    curl "https://contrails.sandbox.googleapis.com/v2/detections/masks?\
key=API_KEY&\
start_time=2026-04-10T00:00:00Z&\
end_time=2026-04-10T01:00:00Z&\
satellite_origin=MTG-000-FULL-DISK"

    Cuando se carga con Xarray, esta solicitud devuelve el siguiente conjunto de datos:

    Dimensiones: (time: 6, y: 5568, x: 5568)
    Coordenadas
    Nombre Dimensiones Tipo de datos Valores
    time (hora) datetime64[ns] 2026-04-10T00:00:07 … 2026-04-10T00:50:07
    y (y) float32 5.569e+06 5.567e+06 … -5.569e+06
    x (x) float32 -5.569e+06 -5.567e+06 … 5.569e+06
    Variables de datos
    mascarilla (tiempo, latitud, longitud) float32 0.0 0.0 0.0 0.0 … 0.0 …
    proyección () DataArray +proj=geos +lon_0=0 +h=35786400 +x_0=0 +y_0=0 +a=6378137 +b=6356752.3 +units=m +no_defs

    Ten en cuenta que projection tiene el formato de la forma de cadena de un objeto pyproj.Proj.

    projection se puede usar para convertir entre las coordenadas x e y del mapa y las coordenadas de longitud y latitud.