A web view of New Zealand’s rooftop solar potential, publicly viewable from: rewiring-nz.github.io/nz-solar-potential/.

Heatmap view of rooftop solarpotential

Panellayout view of rooftop solarpotential
[!WARNING] The map is a planning aid, not a system design, quote or guarantee.
Data maintainers and developers can view their local updates. Use the URL printed when the build finishes; the destination depends on how it ran:
| Build or preview | Where to open it | Availability |
|---|---|---|
| Local quickstart | The printed Map preview URL, usually http://127.0.0.1:8765/rooftop-solar.html?...; also recorded in the run’s report.md |
Only on your computer while the preview server runs. The port can change; the printed URL centres the map on the built region. |
| Shared-cloud quickstart | The printed Developer preview URL: https://storage.googleapis.com/rewiring-solar-previews/devel/GITHUB_ALIAS/rooftop-solar.html |
Public and shareable. The alias opens its latest published preview; previews expire after 14 days unless refreshed. |
| Developer-VM profile | Start the documented --cloud preview SSH tunnel, then open http://127.0.0.1:8765/rooftop-solar.html using the tunnel’s port |
Only on your computer while the VM’s preview server and SSH tunnel run. It is not a public preview URL. |
| District or worker build without preview publication | No browser URL is created by the build alone. Use Serve locally for combined outputs. | Worker outputs must be collected and combined before previewing the complete map. |
| Production release | The public GitHub Pages URL above | Updated only after the release is published and the site’s data pointer switches. |
If automatic browser opening fails, copy the printed URL into your browser.
127.0.0.1 links are local to the person opening them; send a public
developer-preview link when sharing a build with someone else.
The simple map is rooftop-solar.html; old preview.html links redirect to
it, preserving their query string and fragment. Open Tools & docs in the
map’s bottom-left controls to reach Build data or the documentation. Build
data requires its local backend; it cannot run builds from static hosting.
Detailed dataset controls for local build decisions live in the Build data workspace. Open Layers & legend below the map navigation controls. The workspace shares the grouped layer legend and map-layer definitions with the canonical map. Groups can be collapsed, and checkboxes show or hide overlays. Basemap radio buttons choose Aerial (Esri / LINZ) or OpenStreetMap without clearing the other layers. Both basemaps need internet access.
The stack, from top to bottom, is:
Details explains each layer; Zoom fits the map to its extent when known. Select Query beside a vector layer, then click the map to see the attributes of features at that point. Selecting a query layer enables it without hiding other layers. Raster overlays do not expose pixel-value queries; source footprints expose cache metadata rather than raw point-cloud points or raster samples.
On the local Build data server, Local lists cached sources and available calculations in that checkout. Remote Developer and Published source catalogues are not currently available in the panel. Cached extents show file coverage only, not guaranteed valid-data coverage.
kWp is the panels’ nameplate rating at Standard Test Conditions, not
continuous output.kWh figures are model estimates. They use each roof face’s slope and
direction, sunlight calibrated to NIWA measurements, shading from hills,
trees and buildings, and the PV assumptions in config.py.Before installing, get a qualified installer to inspect the site and design the system.