Exemplos de Uso do Método get_all_soundings()

Neste notebook, vamos explorar como utilizar o método get_all_soundings() da classe SondagensClient para recuperar todas as sondagens disponíveis.

Vamos começar importando as bibliotecas necessárias e configurando a autenticação.

from pySINDA import SondagensClient

# Token de autenticação
token = 'seu_token_aqui'

# Instanciando o cliente
sondagens = SondagensClient(token)

Exemplo 1: Obter Todas as Sondagens¶

Neste exemplo, vamos utilizar o método get_all_soundings() para obter a lista completa de sondagens disponíveis e exibir as primeiras entradas da lista.

print('Recuperando todas as sondagens...')
soundings = sondagens.get_all_soundings()
print(soundings[:5])  # Exibindo as primeiras 5 sondagens

Recuperando todas as sondagens...

[{'hora_lancamento': '15:35:22', 'sonda': '66905bcc2a7d527c30bd792e', 'data_lancamento': '2024-07-09'}, {'hora_lancamento': '15:06:36', 'sonda': '668313e3de022bf47e836a35', 'data_lancamento': '2024-06-28'}, {'hora_lancamento': '14:49:41', 'sonda': '667de6a9fe0b5f1a6e6869a3', 'data_lancamento': '2024-06-18'}, ...]

Exemplo 2: Filtrar Sondagens por Data¶

Pode ser interessante filtrar as sondagens por uma data específica. Neste exemplo, vamos filtrar todas as sondagens realizadas em um determinado mês.

import datetime

mes_desejado = '07'
ano_desejado = '2024'
print(f'Sondagens realizadas em {mes_desejado}/{ano_desejado}:')
for sounding in soundings:
    if sounding['data_lancamento'].startswith(f'{ano_desejado}-{mes_desejado}'):
        print(sounding)

Sondagens realizadas em julho de 2024:
{'hora_lancamento': '15:35:22', 'sonda': '66905bcc2a7d527c30bd792e', 'data_lancamento': '2024-07-09'}

Exemplo 3: Contar Sondagens por Data¶

Vamos contar o número total de sondagens realizadas em cada mês para ver como as sondagens são distribuídas ao longo do tempo.

from collections import Counter

contagem_sondagens = Counter(sounding['data_lancamento'][:7] for sounding in soundings)
print('Distribuição de sondagens por mês:')
for data, contagem in contagem_sondagens.items():
    print(f'{data}: {contagem}')

Distribuição de sondagens por mês:
2024-05: 3
2024-06: 2
2024-07: 1

Exemplo 4: Analisar Horário de Lançamento¶

Se for relevante analisar os horários de lançamento das sondagens, podemos extrair e exibir essas informações para identificar padrões.

print('Horários de lançamento das sondagens:')
for sounding in soundings:
    print(sounding['hora_lancamento'])

Horários de lançamento das sondagens:
15:35:22
15:06:36
14:49:41
14:17:24
14:36:07