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 se ejecuta correctamente, la respuesta será un archivo NetCDF de máscaras de detección de estelas de condensación. De forma opcional, también se pueden incluir compensaciones de tiempo de exploración en la respuesta.

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 (incluida). Ten en cuenta que end_time no puede exceder 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

Obligatorio. 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_WEST, GOES_EAST, Himawari y MTG, respectivamente.

Formato: cadena

Ejemplo: "GOES-EAST-FULL-DISK"
view

DetectionMaskView

Opcional. La configuración predeterminada es DETECTION_MASK_VIEW_UNSPECIFIED. Si DETECTION_MASK_VIEW_FULL, incluirá compensaciones de satélite de disco completo (en segundos) en la respuesta.

Formato: Consulta la documentación

Ejemplo: DETECTION_MASK_VIEW_BASIC

Ejemplos

  • Para recuperar máscaras de detección de un satélite para un momento específico con compensaciones de tiempo de exploración, 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"
          "view": "DETECTION_MASK_VIEW_FULL"},
  headers={"x-goog-api-key": API_KEY},
)

    o en CURL:

    curl "https://contrails.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&\
view=DETECTION_MASK_VIEW_FULL"

    Cuando se carga con xarray, esta solicitud muestra el siguiente conjunto de datos:

    Dimensiones: (time: 6, y: 5568, x: 5568)
    Coordenadas
    Nombre Dimensiones Tipo de datos Valores
    time (time) 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 (time, y, x) float32 0.0 0.0 0.0 0.0 ... 0.0 ...
    scantime_offset (time, y, x) float64 nan nan nan nan ... 564. 568. …
    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 cadena de un objeto pyproj.Proj.

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

DetectionMaskView

Define el nivel de detalle que se mostrará para las máscaras de detección.

Enums
DETECTION_MASK_VIEW_UNSPECIFIED Vista no especificada. En la práctica, se trata como BASIC.
DETECTION_MASK_VIEW_BASIC Contiene valores de máscara de detección y datos de proyección satelital.
DETECTION_MASK_VIEW_FULL Contiene valores de máscara de detección, datos de proyección satelital y compensaciones de tiempo de exploración de disco completo.