Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 

Repository files navigation

Auckland Housing Web Map — Affordability · Composition · Quality

A web mapping application that explores how Auckland’s housing has changed over time across Local Board and SA2 boundaries, focusing on affordability, housing composition, and housing quality. The app presents multi‑year choropleths, dot‑density maps, a time slider, searchable pop‑ups, and an attribute table to make complex trends accessible to planners, policymakers, and the public.

Note: This repository is a public landing page for your course project. It hosts the README, links, screenshots, and documentation so you can share it on your resume. The live app runs on the university VM (internal network). Do not publish any private credentials here.


🔗 Quick Links

  • Live app (Massey VM / internal): http://158740g5.massey.ac.nz:3000/index.html
  • Demo video: (upload and paste link, e.g., Drive/YouTube/Vimeo)
  • Project report (PDF): (export your DOCX to PDF and add the link in this repo)
  • Data catalogue (CSV/Markdown): (optional — add a small table listing layer → source)
  • Screenshots: docs/screenshots/ (add 3–6 images of key maps/UI)

If the VM is not accessible outside campus, keep the screenshots and report in this repo so reviewers can still understand the project.


🗺️ What the App Shows

  • Affordability: Rent, income, rent‑per‑income, and house‑price‑per‑income across years (time slider; pop‑ups; searchable table).
  • Composition: Dwellings consented over time; unoccupied dwellings; house types (stand‑alone, joined, other); house sizes by rooms.
  • Quality: Utility access (composite score of water, sewer, power); dampness and mould (2018 vs 2023; percent change).

Key interactions: layer toggles, time slider, pop‑ups, search by Local Board, table with “open & zoom” row action.


🧰 Tech Stack

  • Data store: PostgreSQL + PostGIS
  • Services: GeoServer (WMS/WFS; CQL filtering; SLD styling)
  • Client: Leaflet.js + vanilla JS/HTML/CSS (noUiSlider for timeline)
  • Prep: QGIS (+ light Python/SQL for joins, areal conversions, cleaning)
  • Hosting: Node.js + Express on a course VM (port 3000)

This repo does not include server credentials or live database dumps. If you publish sample SQL, scrub hosts, users, and passwords, and put secrets in a .env file that is .gitignored.


📊 Data Sources (examples — replace with final links)

Create docs/data-catalogue.md (or .csv) listing each layer → source → years → processing notes.


📦 Suggested Repo Layout

.
├─ README.md
├─ docs/
│  ├─ report.pdf                # export of your submitted report
│  ├─ data-catalogue.md         # brief list of layers and sources
│  └─ screenshots/              # 3–6 PNGs (home, affordability, composition, quality)
├─ sql/                         # (optional) sanitized DDL / demo queries (no credentials)
├─ geoserver/                   # (optional) example SLDs (no passwords or internal URLs)
├─ frontend/                    # (optional) static demo snippet or minimal Leaflet example
└─ .gitignore

Minimal .gitignore to keep secrets and noise out of Git:

# Node / build
node_modules/
dist/

# OS / editor
.DS_Store
Thumbs.db
.vscode/

# Secrets / data
.env
*.env
*.key
*.p12
secrets/
data/raw/

▶️ Quick Start (Static Repo)

This repo is documentation‑first. To make it resume‑friendly:

  1. Add screenshots in docs/screenshots/ (home page; affordability; composition; quality).
  2. Export your report to PDF and put it in docs/report.pdf.
  3. Paste the demo video link above.
  4. (Optional) Add a small data-catalogue file and sanitized SQL/SLDs.

If you want a small interactive demo here, add a minimal Leaflet page in frontend/ and publish on GitHub Pages. Point it to a public WMS/WFS or to pre‑baked GeoJSON (no university credentials).


👥 Team (Group 05)

List contributors and roles (examples — update to credit your teammates):

  • Data ingestion & joins; composition layers — Travis
  • Affordability layers (rent, income, price) — Nethmi
  • Utilities & Stats NZ layers; integration — Arjun
  • Unoccupied dwellings; QA & styling — YiFan

Replace or expand this section as needed. Use full names if your teammates agree.


✍️ How to Cite

Auckland Housing Web Map — Affordability · Composition · Quality (Group 05).
University course project, Auckland, 2025. GitHub repo: https://github.com/your‑username/auckland‑housing‑webmap


📄 Resume Block (copy/paste)

title: Open‑Source Web Mapping Application — Location Systems (Spatial Databases, Tools & Applications)
description: Built a VM‑hosted web GIS (Leaflet + PostGIS + GeoServer) with time sliders, choropleths/dot‑density, pop‑ups, search, and a data table. Layers cover affordability, composition, and quality, with QGIS/SQL processing and documented architecture.
application: Interactive spatial decision support for housing policy (Auckland).
link: Live (internal) – http://158740g5.massey.ac.nz:3000/index.html · Repo – https://github.com/your‑username/auckland‑housing‑webmap · Report – add PDF


⚖️ License

Choose a simple license — e.g., MIT for code; and note that data may be under third‑party licenses. Add attribution for Stats NZ/Infometrics/Koordinates/Watercare/Vector as required.

About

built, production-quality web map using an open-source stack.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors