このプロジェクトについて

このリポジトリは、Monash Universityが公開している駐車場の空き状況データを収集するものです。大学は、駐車場センサーが設置されているすべての主要な駐車場を含む、空き状況をリスト化した公開JSONファイルを公開しています。このJSONは2分ごとに更新され、公開URLで提供されており、本プロジェクトのデータソースとして利用されています。 リポジトリの中心となるのは、単一のPythonスクリプトであるscraper.pyです。このスクリプトはJSONを読み取り、その結果をmonash_all_parking_availabilities.csvという名前のCSVファイルに記録します。このスクリプトは手動ではなく自動的に実行されるように設計されており、ワークフローファイルであるscrape.ymlを通じてGitHub Actionsで実行され、外部スケジューリングサービスのcron-job.orgによって6分ごとにトリガーされます。作者によると、データの蓄積は2026年8月21日に開始され、CSVファイルは当面の間増え続ける見込みであり、得られたデータは法的に問題のない範囲で誰でも自由に使用できるとしています。 READMEには、プロジェクトの経緯が率直に記されています。これは作者にとって初めてのGitHubプロジェクトであり、主にGitHubの仕組みを学ぶための手段として取り組まれたものです。ほとんどのスクリプトは作者の監督下でGeminiアシスタントの助けを借りて作成され、リポジトリの設定もアシスタントの指示に従いました。作者は、データが最終的に膨大になることに言及しています。2026年8月29日付の更新では、約5ヶ月でファイルサイズ制限に達する可能性が高いとしており、今後の予定を挙げています。その計画には、すべてのデータシリーズの分析、駐車場N1（全許可証）およびその他のブルーまたはレッド許可証駐車場の有効なシリーズへの収集制限、データのワイドフォーマットでの保存（1年以内に変更されるシリーズが少ないため、データは疎ではなく密であるべきだという理由から）が含まれています。また、過去の傾向に基づいて1時間後に駐車スペースが空いているかを予測するGitHubウェブページの公開や、月別ファイルに分割される可能性のあるCSVデータのインタラクティブなビューの提供も検討されています。 現状において、このプロジェクトはシンプルなスケジュール済みデータ収集パイプラインです。ソースとしてのホスト済みJSONエンドポイント、取得と追記を行うPythonスクリプト、実行のためのGitHub Actionsワークフロー、そしてタイミング制御のための外部cronサービスで構成されています。READMEには、認証、パースの詳細、エラーハンドリング、または分析ツールについての記述はなく、リストアップされた今後の項目は実装済みの機能ではなく意向として述べられています。