Recuperar máscaras de detecção

GET https://contrails.googleapis.com/v2/detections/masks: recebe máscaras de detecção de rastros de condensação no formato NetCDF4.

Se a solicitação for bem-sucedida, a resposta será um NetCDF de máscaras de detecção de rastros de condensação. Como opção, os deslocamentos de scantime também podem ser incluídos na resposta.

Parâmetros de consulta

Parâmetros
start_time

string

Obrigatório. Horário de início da solicitação.

Formato: string de data e hora ISO 8601

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

string

Obrigatório. Horário de término da solicitação (inclusivo). end_time não pode exceder start_time em mais de uma hora.

Formato: string de data e hora ISO 8601

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

string

Obrigatório. Os valores válidos são GOES-WEST-FULL-DISK, GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK e MTG-000-FULL-DISK, que representam os satélites GOES_WEST, GOES_EAST, Himawari e MTG, respectivamente.

Formato: string

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

DetectionMaskView

Opcional. O valor padrão é DETECTION_MASK_VIEW_UNSPECIFIED. Se DETECTION_MASK_VIEW_FULL, vai incluir offsets de satélite de disco completo (em segundos) na resposta.

Formato: consulte a documentação

Exemplo: DETECTION_MASK_VIEW_BASIC

Exemplos

  • Para recuperar máscaras de detecção de um satélite para um ponto específico no tempo com intervalos de tempo de varredura:

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

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

    Quando carregada com xarray, essa solicitação retorna o seguinte conjunto de dados:

    Dimensões: (time: 6, y: 5568, x: 5568)
    Coordenadas
    Nome Dimensões Tipo de dados Valores
    time (horário) 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
    Variáveis de dados
    máscara (tempo, y, x) float32 0.0 0.0 0.0 0.0 ... 0.0 ...
    scantime_offset (tempo, y, x) float64 nan nan nan nan ... 564. 568. …
    projeção () DataArray +proj=geos +lon_0=0 +h=35786400 +x_0=0 +y_0=0 +a=6378137 +b=6356752.3 +units=m +no_defs

    Observe que projection é formatado como a forma de string de um objeto pyproj.Proj.

    projection pode ser usado para converter entre coordenadas x, y do mapa e coordenadas de longitude e latitude.

DetectionMaskView

Define o nível de detalhe a ser retornado para máscaras de detecção.

Tipos enumerados
DETECTION_MASK_VIEW_UNSPECIFIED Visualização não especificada. Na prática, isso é tratado como BASIC.
DETECTION_MASK_VIEW_BASIC Contém valores de máscara de detecção e dados de projeção de satélite.
DETECTION_MASK_VIEW_FULL Contém valores de máscara de detecção, dados de projeção de satélite e offsets de tempo de varredura de disco completo.