poster-map

アプリケーション概要

• 選挙の際にポスターを貼るべき看板の位置を登録し、自陣営のポスター貼付け状況を管理できるシステムです
• 2024年東京都知事選で安野たかひろ陣営が運用していたシステムをオープンソースとして公開可能な形に調整したものです
• 都知事選での運用の詳細はこちらのnote記事をご確認ください。

ライセンスについて

• このプロジェクトはGPL-3.0 licenseにて公開されています。
• ただし、自治体などの組織が利用する時、調整が必要な場合には個別にご相談ください。
• 相談する場合は [email protected] にご連絡ください。

コントリビュートについて

• プロジェクトへのコントリビュートの際には、コントリビューターライセンス契約（CLA）への同意が必須となります。ご了承ください。

動作サンプル

https://anno-poster-map.netlify.app/

サイトマップ

• /: トップページ（各ポスターマップへのメニュー）
• /map: ポスターマップ
  • ?block=BLOCKNAME とパラメータを設定することで、特定の地区のみ表示可能
  • 23-city, 23-east, 23-west, tama-north, tama-south, tama-west, island
• /summary: 市区町村ごとの完了率をヒートマップとして可視化したマップ
• /vote: 期日前投票所のみを表示したマップ

環境

• Google Spreadsheet / Google Apps Script
  • 掲示板の位置情報/貼り付け状況を管理するデータベースとして使用
  • Google Apps Script (GAS)を使用し、シート内のデータをCSVとしてWeb公開
• 定期実行サーバ
  • GASで公開したCSVを加工/集計してJSONを生成するのに使用
  • Pythonが使える環境 (Linux, macOS, WSL2等を推奨)
  • クラウド上のインスタンスでも、オンプレミスの物理マシンでもOK（重い処理はないのでRaspberry Piなどで良い）
• Netlify
  • https://anno-poster-map.netlify.app といったURLで、Webサービスを公開できる (基本的に無料で利用可能)
  • netlify-cliを使ってサーバーからNetlifyにpublic/ディレクトリを直接デプロイ

公開データ

• data/arealist.json: 市区町村名とそれに対応するID一覧 (JSON)
• data/all.csv: 全掲示板データ(CSV)
  • 取得元はGoogle Spreadsheet (Google Apps ScriptでCSVとしてWebに公開)
  • このCSVを各種スクリプトで加工することで、配信用のJSON(all.json, summary.jsonなど)を生成している
  • 列
    • area: 地区名
    • name: 掲示板番号
    • lat: 緯度
    • long: 軽度
    • status: 0 (未), 1 (完了), 2 (異常), 3 (予約), 4 (要確認), 5 (異常対応中), 6 (削除)
    • note: 備考（ピンの吹き出しに表示される）

area,name,lat,long,status,note
北区,1-1,35.737156,139.757525,1,
北区,1-2,35.7347132,139.7590379,2,他候補貼り間違え
北区,1-3,35.7343472,139.7612792,0,

• data/all.json: 全掲示板データ(JSON)
• data/summary.json: 市区町村別の貼り付け完了率 (JSON)
• data/summary_absolute.json: 市区町村別の未貼り付け掲示板数（絶対数） (JSON)
• data/vote_venue.json: 期日前投票所位置データ (JSON)

スクリプト

• csv2json_small.py: 元データのCSVをLeaflet用にJSONとして書き出す
• summarize_progress.py: 地域別/全体の完了率をJSONとして書き出す
• summarize_progress_absolute.py: 地域別/全体の未貼り付け掲示板数をJSONとして書き出す
• main.sh: 上記Pythonスクリプトを実行し、GitHubにデータをコミットし、Netlifyに公開する処理を一括で実行するシェルスクリプト (cronからの定期実行用)

# Download original CSV file
curl -sL "https://example.com/all.csv" > public/data/all.csv
# pip install -r requirements.txt
python csv2json_small.py <original_data.csv> <output_dir>
python summarize_progress.py <output_path>

# Run this regularly with cron
# If you're not in rush, you could run this on GitHub actions
bash path/to/tokyo2024-poster-map/main.sh

定期実行

cronでデータ更新を定期実行

# cronの設定を変更
crontab -e

# 5分ごとに定期実行する場合
*/5 * * * * path/to/tokyo2024-poster-map/main.sh

開発環境

ポスターマップの動作確認をする際は、ローカルでHTTPサーバを立ち上げる。

npx http-server

謝辞

本プロジェクトでは、以下のライブラリや公開データを使用させていただきました。この場を借りて開発者・コントリビューターの皆様に感謝申し上げます。

• Leaflet
  • 地図上での可視化に使用
• Bootstrap
  • トップページのメニューに使用 (CSSのみ)
• Linked Open Addresses Japan
  • /summaryページで進捗を可視化する際に、各市区町村のポリゴンを利用
• OpenStreetMap, 国土地理院地図, Google Map
  • ベースマップとして利用