Recuperar detecções

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

Se for bem-sucedida, a resposta será uma FeatureCollection no formato GeoJSON. É possível retornar uma FeatureCollection vazia se o período estiver fora do escopo (por exemplo, pesquisar rastros de aviões detectados no futuro). Além disso, não há garantia de consistência nas detecções, já que os modelos de detecção são atualizados e os dados são preenchidos.

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-EAST-FULL-DISK, HIMAWARI-FULL-DISK e MTG-000-FULL-DISK, que representam os satélites GOES_EAST, Himawari e MTG, respectivamente.

Se fornecido, esse endpoint vai retornar apenas rastros de aviões detectados de satélites especificados em satellite_origins.

Se não for fornecido, retorna rastros de aviões detectados de todos os provedores de dados de satélite aplicáveis.

Formato: matriz de strings

Exemplo: ["GOES-EAST-FULL-DISK", "HIMAWARI-FULL-DISK"]

Exemplos

  • Para recuperar todas as detecções de rastros de aviões para um momento 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 detecções de rastros de aviões para um momento 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.sandbox.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"

Uma resposta bem-sucedida com rastros de aviões detectados será parecida com esta:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            90.06765747070312,
            44.201324462890625
          ],
          [
            90.99974060058594,
            43.65225601196289
          ]
        ]
      },
      "properties": {
        "time": "2026-03-10T00: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-03-10T00:00:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    }
  ]
}