Executando verificação de segurança...
45
Andreldev
2 min de leitura ·

API Tábua de marés FREE!

Eu construí a Tábua de Marés API, uma API REST gratuita e sem necessidade de chave que entrega dados das marés do litoral brasileiro. Ela cobre todos os estados costeiros e já tem documentação e playground prontos para qualquer dev integrar em minutos.

Minhas motivações foram as seguintes:

  1. Eu ia trabalhar em um freela que precisava entregar automaticamente a altura da maré. Passeios de catamarã são vendidos conforme a maré, porque depois paramos nas piscinas naturais (pelo menos é assim na Paraíba). Eu queria que isso fosse automático, sem depender de alguém consultar manualmente tabelas. (Infelizmente não foi para frente o freela)

  1. Eu sempre admirei projetos como a BrasilAPI e o CNPJfy, e queria criar algo do mesmo jeito: simples, direto, público e útil para qualquer dev.

  2. A Marinha brasileira só entrega os dados em PDF. Existem sites incríveis para visualizar as marés, mas não existia uma forma prática de consultar via API. Então eu transformei esses PDFs em endpoints claros, fáceis de consumir e prontos para colocar em qualquer aplicação.

O resultado é uma API leve (99% menos cO2), feita para integrar em sistemas de turismo, apps de navegação, bots de alerta ou qualquer serviço que dependa da maré.

E tudo acima eu já falei como conseguir nos seguintes post:

Todos eles se complementam!

Para acessar a API ou ler mais sobre, acesse: Tábua de Marés

Eu criei porque eu precisava, mas agora disponibilizo para qualquer um que também precise transformar informação bruta em algo realmente útil.


blog: https://andrelz.invdual.com/
YT: https://www.youtube.com/@mais.foco42
IN: https://www.linkedin.com/in/andreluizss/
TN: https://www.tabnews.com.br/Andreldev
X: https://x.com/luizdidev

Fonte: https://www.invdual.com/user/andrelz/blog/api-tbua-de-mars-free-mgf5qdqi

Carregando publicação patrocinada...
2
Oletros

Meus 2 cents,

Obrigado por compartilhar !

Achei o projeto simples (no bom sentido) mas bem acabado: parabens pela iniciativa !

Algumas duvidas - dei uma olhada no codigo e:

  1. Porque usar a linguagem 'V' ? Como foi sua jornada com ela ?

  2. Voce utilizou algum script para converter os dados de PDF para BD ou foi via IA/LLM (p.ex. gepeto, claude, etc) ?

Saude e Sucesso !

6
Andreldev
  • Autor
    Autor

  1. Porque eu gosto da construção da sintaxe da linguagem.
    Ela se vende como segura, e muito rápida. Ela está em fase beta desde 2019, e até 2030 não vai sair de beta acredito eu. Ela tem muito que amadurecer. Quanto mais pessoas utilizando, mais pessoas reportando problemas e a linguagem amadurecendo. A minha jornada é de várias desistência, por ela me deixar na mão em algum ponto, ai eu subo uma issue, ou quando tenho conhecimento técnico, resolvo o problema. Pra mim ela é a junção do que tem de melhor de rust + go.

  2. Nada de IA, quando tentei foi uma dor, então fiz na mão, utilizei pra codar boilerplate, ta aqui o projeto que faz a subida dos dados para o banco de dados, já ta até com o pdf, se quiser subir para uma base de dados sua, é construído em V também. https://github.com/Ddiidev/tabua_mare_convert_pdf2db

Obrigado mestre, que bom que viu a visão do simples! Ontem adicionei cache só pra complicar 'kkkkkk
Mas sim, é o mais simples que consegui fazer agora, implementei o cache do 0 em memória, se quiser assistir a live (muito grande, nem eu assistiria): https://www.youtube.com/watch?v=hk2i6yDm0fo

2
Oletros

Dei uma olhada no codigo de extracao - nao sei se eh a clareza da linguagem ou a limpeza do teu estilo, mas deu para entender bem o funcionamento do V e das funcoes que voce utilizou: novamente, parabens !

Quanto ao video - pois eh um pouco longo, mas o que pegou foi o audio: como ficou abafado em diversos momentos nao para entender o dialogo, talvez algum plugin do OBS possa ajudar.

Saude e Sucesso !

1
IanMiranda

Parabéns pelo projeto e pela iniciativa mano.
Mas uma dúvida, a API faz cálculos pra saber como vai estar a maré ou ela conta com alguma base de dados que ja fornece essas informações?

Ah, fui acessar agr à API e deu um erro de Bad Gateway.

2
Andreldev
  • Autor
    Autor

Obrigado!
A api não faz nenhum cálculo, o dado já vem pronto. A marinha que disponibiliza esses dados, o que eu faço é transforma os dados que a marinha disponibiliza em formato pdf para uma api de fácil acesso e consultável.

Se quiser olhar o código que faz a conversão, ta aqui:
https://github.com/Ddiidev/tabua_mare_convert_pdf2db
pode baixar e testar, ou só baixar os pdf, é opensource tanto a api quanto o convert.

Sobre o Bad Gateway.
Sim, eu identifiquei esse problema do serviço cair sem mais nem menos, só vou conseguir saber o porque disso, depois que adicionar logs para monitorar.

E é peso, é um serviço de VPS free, é tão limitado que pode ser esse o problema. A maquina com pouco recurso!

0