Recuperar detecções

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

Se a solicitação for bem-sucedida, a resposta será um 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 do GOES, as coordenadas retornadas também incluem valores de altitude especulados.

Consultar detecções com um período fora do escopo, como um horário especificado no futuro, retorna um FeatureCollection vazio.

Observação: as detecções de MTG estão em 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). end_time não pode exceder 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-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 rastros de condensação detectados de satélites especificados em satellite_origins. Quando não está presente, retorna rastros de condensação 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 no formato "latitude,longitude", que especifica os vértices de um polígono delimitador. Se estiver presente, pelo menos três bounds precisam ser especificados. Os limites precisam formar um polígono válido (por exemplo, sem vértices duplicados ou autointerseção). Quando presente, esse endpoint só retorna rastros de condensação detectados que se cruzam com qualquer parte do polígono delimitador. Quando não está presente, retorna rastros de condensação detectados, independente 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 rastros de condensação 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 rastros de condensação em um período específico, limitado por um 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 rastros de condensação em um período específico, limitado a detecções do 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 rastros de condensação dos 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"
        }
      }
    ]
  }