Ir para o conteúdo
Occult API
GET/api/hazard/forest-fires/1 crédito

Incêndios florestais

Um conjunto de dados armazenado de detecções de grandes incêndios florestais, organizado segundo a hierarquia administrativa florestal da Índia. É um registro histórico de eventos, não um cálculo astrológico, e é fornecido para trabalhos de astrologia mundana e de correlação junto com os endpoints de mapas. Filtre com `state`, `district`, `circle`, `division` e `fire_name`, todos com correspondência por substring, sem diferenciar maiúsculas de minúsculas, e com `start_date`/`end_date` aplicados ao horário da primeira detecção (aceitando YYYY-MM-DD ou um timestamp ISO completo). `sort` aceita 'newest' (o padrão), 'oldest', 'name_asc' ou 'name_desc' pelo nome do incêndio. A paginação usa `page` e `itemsPerPage`: cinquenta por página por padrão e até quinhentos. A resposta é um envelope paginado padrão com `count`, `next`, `previous` e `results`. Cada resultado traz um id, os timestamps `first_detection` e `last_detection`, o estado, o distrito, o círculo florestal, a divisão e o range, um nome de incêndio e as coordenadas do ponto como `latitude` e `longitude`. Os campos administrativos são null para detecções fora de uma divisão florestal mapeada.

https://api.occultapi.com/api/hazard/forest-fires/
Testar requisição

Autenticação

Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.

X-API-Key: yt_live_a1b2c3d4_…

Parâmetros de query (10)

Vão na URL. Todos são opcionais, a menos que estejam marcados, e podem ser combinados — primeiro filtre, depois pagine, depois ordene.

ParâmetroTipoExemploPara que serve
circlestring—Filtrar por nome do círculo (contém; sem diferenciar maiúsculas de minúsculas)
districtstring—Filtrar por nome do distrito (contém; sem diferenciar maiúsculas de minúsculas)
divisionstring—Filtrar por nome da divisão (contém; sem diferenciar maiúsculas de minúsculas)
end_datestring—Filtrar por data/hora final (YYYY-MM-DD ou YYYY-MM-DDTHH:MM:SS)

Restrição de FORMATO: 'YYYY-MM-DD' ou 'YYYY-MM-DDTHH:MM:SS'. Comparado com `first_detection__lte`.

fire_namestring—Filtrar por nome do incêndio (contém; sem diferenciar maiúsculas de minúsculas)

FORMATO LIVRE; correspondência por substring `icontains`, sem diferenciar maiúsculas de minúsculas, no nome do incêndio.

itemsPerPageinteger—Número de itens por página
pageinteger—Número da página
sortstring—Ordem de classificação: 'newest' (padrão), 'oldest', 'name_asc' (nome do incêndio, A-Z) ou 'name_desc' (Z-A)

Não diferencia maiúsculas de minúsculas; os espaços nas extremidades são removidos. Padrão: 'newest'. QUALQUER valor não reconhecido recorre silenciosamente a 'newest' em vez de gerar erro. 'name_asc'/'name_desc' ordenam por fire_name. Valores null sempre ficam por último.

um destes: newest, oldest, name_asc, name_desc
start_datestring—Filtrar por data/hora inicial (YYYY-MM-DD ou YYYY-MM-DDTHH:MM:SS)

Restrição de FORMATO: 'YYYY-MM-DD' ou 'YYYY-MM-DDTHH:MM:SS'. Comparado com `first_detection__gte`.

statestring—Filtrar por nome do estado (contém; sem diferenciar maiúsculas de minúsculas)

Exemplo de requisição

curl "https://api.occultapi.com/api/hazard/forest-fires/" \
  -H "X-API-Key: $OCCULT_API_KEY"

Resposta

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"count\": 100, \"next\": \"https://api.occultapi.com/api/hazard/forest-fires/?page=2\", \"previous\": null, \"results\": [{\"id\": 66, \"first_detection\": \"2025-06-09T13:30:00+05:30\", \"last_detection\": \"2025-06-09T13:30:00+05:30\", \"state\": \"UTTAR PRADESH\", \"district\": \"AGRA\", \"circle\": null, \"division\": null, \"range_name\": null, \"fire_name\": \"AGRA -1\", \"longitude\": 78.26051634, \"latitude\": 26.83035862}, {\"id\": 9, \"first_detection\": \"2025-04-29T01:48:00+05:30\", \"last_detection\": \"2025-04-29T01:48:00+05:30\", \"state\": \"RAJASTHAN\", \"district\": \"SIROHI\", \"circle\": \"CCF JODHPUR CIRCLE\", \"division\": \"SIROHI DIVISION\", \"range_name\": \"ABU ROAD RANGE\", \"fire_name\": \"ABU ROAD -5\", \"longitude\": 72.88706718, \"latitude\": 24.50238094}, {\"id\": 65, \"first_detection\": \"2025-04-28T02:07:00+05:30\", \"last_detection\": \"2025-04-29T01:48:00+05:30\", \"state\": \"HIMACHAL PRADESH\", \"district\": \"HAMIRPUR\", \"circle\": \"HAMIRPUR CIRCLE\", \"division\": \"HAMIRPUR DIVISION\", \"range_name\": \"AGHAR RANGE\", \"fire_name\": \"AGHAR -2\", \"longitude\": 76.54487903, \"latitude\": 31.61348206}, {\"id\": 20, \"first_detection\": \"2025-04-27T13:36:00+05:30\", \"last_detection\": \"2025-04-27T13:36:00+05:30\", \"state\": \"ANDHRA PRADESH\", \"district\": \"ALLURI SITHARAMA RAJU\", \"circle\": \"RAJAHMUNDRY CIRCLE\", \"division\": \"RAMPACHODAVARAM DIVISION\", \"range_name\": \"ADDATEEGALA RANGE\", \"fire_name\": \"ADDATEEGALA -8\", \"longitude\": 81.84477321, \"latitude\": 17.71221588}, {\"id\": 64, \"first_detection\": \"2025-04-26T13:54:00+05:30\", \"last_detection\": \"2025-04-26T13:54:00+05:30\", \"state\": \"HIMACHAL PRADESH\", \"district\": \"HAMIRPUR\", \"circle\": \"HAMIRPUR CIRCLE\", \"division\": \"HAMIRPUR DIVISION\", \"range_name\": \"AGHAR RANGE\", \"fire_name\": \"AGHAR -1\", \"longitude\": 76.56248482, \"latitude\": 31.57775419}, {\"id\": 70, \"first_detection\": \"2025-04-23T13:10:00+05:30\", \"last_detection\": \"2025-04-23T13:10:00+05:30\", \"state\": \"MADHYA PRADESH\", \"district\": \"SHEOPUR\", \"circle\": \"KUNO VAN PRANI SHEOPUR CIRCLE\", \"division\": \"KUNO PALPUR VAN PRANI SHEOPUR DIVISION\", \"range_name\": \"AGRA WEST RANGE\", \"fire_name\": \"AGRA WEST -4\", \"longitude\": 77.20371276, \"latitude\": 25.993098}, {\"id\": 100, \"first_detection\": \"2025-04-20T14:06:00+05:30\", \"last_detection\": \"2025-04-20T14:06:00+05:30\", \"state\": \"MAHARASHTRA\", \"district\": \"AHMEDNAGAR\", \"circle\": \"WILDLIFE WEST CIRCLE\", \"division\": \"CCF WILDLIFE PUNE DIVISION\", \"range_name\": \"REHEKURI RANGE\", \"fire_name\": \"AHMEDNAGAR -36\", \"longitude\": 75.14123428, \"latitude\": 18.52634684}, {\"id\": 99, \"first_detection\": \"2025-04-19T14:25:00+05:30\", \"last_detection\": \"2025-04-19T14:25:00+05:30\", \"state\": \"MAHARASHTRA\", \"district\": \"AHMEDNAGAR\", \"circle\": \"NASHIK CIRCLE\", \"division\": \"AHMEDNAGAR DIVISION\", \"range_name\": \"PARNER RANGE\", \"fire_name\": \"AHMEDNAGAR -35\", \"longitude\": 74.32290649, \"latitude\": 19.14418074}, {\"id\": 69, \"first_detection\": \"2025-04-17T02:13:00+05:30\", \"last_detection\": \"2025-04-17T02:13:00+05:30\", \"state\": \"MADHYA PRADESH\", \"district\": \"SHEOPUR\", \"circle\": \"KUNO VAN PRANI SHEOPUR CIRCLE\", \"division\": \"KUNO PALPUR VAN PRANI SHEOPUR DIVISION\", \"range_name\": \"AGRA WEST RANGE\", \"fire_name\": \"AGRA WEST -3\", \"longitude\": 77.20165544, \"latitude\": 25.95699487}, {\"id\": 98, \"first_detection\": \"2025-04-16T02:31:00+05:30\", \"last_detection\": \"2025-04-16T02:31:00+05:30\", \"state\": \"MAHARASHTRA\", \"district\": \"AHMEDNAGAR\", \"circle\": \"NASHIK CIRCLE\", \"division\": \"SANGAMNER DIVISION\", \"range_name\": \"RAJUR RANGE\", \"fire_name\": \"AHMEDNAGAR -34\", \"longitude\": 73.90079744, \"latitude\": 19.6026871}, {\"id\": 97, \"first_detection\": \"2025-04-16T02:31:00+05:30\", \"last_detection\": \"2025-04-16T02:31:00+05:30\", \"state\": \"MAHARASHTRA\", \"district\": \"AHMEDNAGAR\", \"circle\": \"NASHIK CIRCLE\", \"division\": \"AHMEDNAGAR DIVISION\", \"range_name\": \"PARNER RANGE\", \"fire_name\": \"AHMEDNAGAR -33\", \"longitude\": 74.57595382, \"latitude\": 18.97076079}, {\"id\": 96, \"first_detection\": \"2025-04-14T14:19:00+05:30\", \"last_detection\": \"2025-04-14T14:19:00+05:30\", \"state\": \"MAHARASHTRA\", \"district\": \"AHMEDNAGAR\", \"circle\": \"NASHIK CIRCLE\", \"division\": \"AHME"
}

Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.

Erros

Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.