Recuperar detecções

GET https://contrails.googleapis.com/v2/detections: recebe detecções de contrails no formato GeoJSON LineString.

Se for bem-sucedida, a resposta será uma FeatureCollection no formato GeoJSON.

As coordenadas retornadas são a longitude e a latitude dos endpoints da detecção linearizada, projetadas na superfície da Terra da perspectiva do satélite. Para detecções GOES, as coordenadas retornadas também incluem valores de altitude especulados.

A consulta de detecções com um período fora do escopo, como um horário especificado no futuro, retorna uma FeatureCollection vazia.

**Observação**: as detecções de MTG estão na versão Beta e sujeitas a mudanças.

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). O end_time não pode exceder o start_time em mais de 24 horas. Formato: string de data e hora ISO 8601 Exemplo: 2026-01-20T22:00:00Z
satellite_origins[]	string Opcional. 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_EAST, Himawari e MTG, respectivamente. Quando presente, esse endpoint só retorna contrails detectados de satélites especificados em satellite_origins. Quando não está presente, retorna contrails detectados de todos os provedores de dados de satélite aplicáveis. Formato: matriz de strings Exemplo: ["GOES-EAST-FULL-DISK", "HIMAWARI-FULL-DISK"]
bounds[]	string Opcional. Uma lista de pares de strings, cada um deles precisa estar no formato "latitude,longitude", especificando os vértices de um polígono delimitador. Se presente, pelo menos três bounds precisam ser especificados. Os limites precisam formar um polígono válido (por exemplo, sem vértices duplicados, sem autointerseção). Quando presente, esse endpoint só retorna contrails detectados que se cruzam com qualquer parte do polígono delimitador. Quando não está presente, retorna contrails detectados, independentemente do local. Formato: matriz de strings Exemplo: ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]

Exemplos

• Para recuperar todas as detecções de contrail em um período específico:

  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 as detecções de contrail em um período específico, limitado pelo polígono delimitador:

  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 detecções de contrail em um período específico, limitado às detecções de Himawari:

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

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

  A resposta GeoJSON para essa solicitação lista dados de detecção de contrail de satélites Himawari para o 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"
        }
      }
    ]
  }