Sobre o projeto

Este repositório coleta dados de vagas de estacionamento publicados pela Monash University. A universidade disponibiliza um arquivo JSON público que lista a disponibilidade de estacionamento para cada estacionamento da Monash equipado com sensores, incluindo todos os principais. Esse JSON é atualizado a cada dois minutos e está disponível em uma URL pública, que o projeto utiliza como sua fonte de dados. O repositório centra-se em um único script Python, scraper.py, que lê esse JSON e registra os resultados em um arquivo CSV chamado monash_all_parking_availabilities.csv. O script foi projetado para ser executado automaticamente, em vez de manualmente: um arquivo de workflow, scrape.yml, o executa através do GitHub Actions, e as execuções são acionadas a cada seis minutos pelo serviço de agendamento externo cron-job.org. O autor afirma que a acumulação de dados começou em 21 de agosto de 2026 e que espera-se que o CSV continue crescendo no futuro previsível, e que qualquer pessoa pode usar os dados resultantes como desejar, legalmente. O README é sincero sobre as origens do projeto. É o primeiro projeto do autor no GitHub e foi realizado principalmente como uma forma de aprender como o GitHub funciona. A maioria dos scripts foi escrita com a ajuda do assistente Gemini sob a supervisão do autor, e a configuração do repositório seguiu as instruções do assistente. O autor observa que os dados eventualmente se tornarão volumosos: uma atualização datada de 29 de agosto de 2026 diz que os limites de tamanho de arquivo provavelmente serão atingidos em cerca de cinco meses, e lista o trabalho de acompanhamento pretendido. Esses planos consistem em analisar todas as séries de dados; restringir a coleta às séries ativas para o estacionamento N1 (todas as permissões) mais outros estacionamentos de permissão azul ou vermelha; armazenar os dados em um formato amplo, sob o raciocínio de que os dados devem ser densos em vez de esparsos, dado quão poucas séries mudam dentro de um ano; e possivelmente publicar uma página no GitHub que mostre, com base em tendências históricas, se uma vaga de estacionamento terá previsão de disponibilidade com uma hora de antecedência, juntamente com uma visualização interativa dos dados do CSV, que podem ser divididos em arquivos mensais. Em seu estado atual, o projeto é um pipeline de coleta de dados agendado e direto: um endpoint JSON hospedado como fonte, um script Python de busca e anexo, um workflow do GitHub Actions para execução e um serviço cron externo para temporização. O README não descreve autenticação, detalhes de parsing, tratamento de erros ou qualquer ferramenta de análise, e os itens futuros listados são declarados como intenções, e não como funcionalidades implementadas.