WCC ArcGIS NZ

Goal

Search and query Wellington City Council and Greater Wellington Regional Council ArcGIS open data — flood/coastal hazard overlays, road network, community facilities, and the Pōneke Travel Insights transport sensors — through a deterministic read-only CLI with human and JSON output.

Use this when

• A task needs Wellington-region open geospatial layers (flood hazard, coastal inundation, roads, facilities, district plan overlays) as GeoJSON
• A task needs to discover what datasets WCC or GWRC publish (--portal gwrc)
• A task needs ArcGIS item/layer metadata, a raw count or object-ID page, or a raw MapServer point identify for agent-side composition
• A task needs pedestrian/cyclist/vehicle count locations or recent counts from WCC's VivaCity transport sensors

Do not use this for

• NZTA state-highway data (use nz-road-closures or nzta-crash-data-nz)
• LINZ national datasets (use linz-data-service)
• Real-time transit vehicle positions (use nz-buses / nz-trains)
• Any write, upload, or account action

Commands

python3 skills/wcc-arcgis-nz/scripts/cli.py search "flood hazard" --limit 5 --start 1
python3 skills/wcc-arcgis-nz/scripts/cli.py search river --portal gwrc --type "Feature Service" --start 11 --json
python3 skills/wcc-arcgis-nz/scripts/cli.py item 8292f1b6b6144a73ae2bc81fd795f067 --json
python3 skills/wcc-arcgis-nz/scripts/cli.py layers 8292f1b6b6144a73ae2bc81fd795f067
python3 skills/wcc-arcgis-nz/scripts/cli.py describe https://mapping1.gw.govt.nz/arcgis/rest/services/GW/Emergencies_P/MapServer --layer-id 10 --json
python3 skills/wcc-arcgis-nz/scripts/cli.py query 8292f1b6b6144a73ae2bc81fd795f067 --bbox "174.75,-41.35,174.82,-41.27" --limit 20 --json
python3 skills/wcc-arcgis-nz/scripts/cli.py query https://services1.arcgis.com/CPYspmTk3abe6d7i/arcgis/rest/services/dp_ihp_recommended_flood_hazard_overlays/FeatureServer/51 --count --json
python3 skills/wcc-arcgis-nz/scripts/cli.py identify https://gis.wellingtonwater.co.nz/server1/rest/services/Modelling/WCC100yrCC2025FloodDepths_FB/MapServer --point 174.78,-41.29 --layer-id 0 --no-geometry --json
python3 skills/wcc-arcgis-nz/scripts/cli.py sensors --search cuba --json
python3 skills/wcc-arcgis-nz/scripts/cli.py sensors-latest --limit 20 --json

• search KEYWORD [--portal wcc|gwrc] [--type TYPE] [--limit N] [--start N] [--json] — org-scoped catalogue search, newest first; use next_start for the next upstream page
• item ITEM_ID [--json] — normalized catalogue metadata including ownership, organisation, access, licence, description, tags, timestamps, size, and the raw item URL; service_url is set only for Feature/Map Service items
• layers ITEM_OR_URL [--json] — layers/tables of a verified WCC/GWRC Feature/Map service
• describe SERVICE [--layer-id N] [--json] — normalized service/layer metadata: fields, aliases, types, descriptions/units when published, extent, spatial reference, capabilities, geometry type, object-ID field, and record limit
• query LAYER [--layer-id N] [--where SQL] [--bbox minLon,minLat,maxLon,maxLat] [--fields F1,F2] [--limit N] [--count|--ids-only] [--no-geometry] [--offset N] [--order-by EXPR] [--geometry-precision N] [--max-allowable-offset N] [--json] — GeoJSON features or a normalized count/object-ID envelope
• identify SERVICE --point LON,LAT [--layer-id N] [--tolerance N] [--no-geometry] [--json] — raw MapServer identify results for selected/all layers
• sensors [--search TEXT] [--limit N] [--json] — transport sensor countlines with coordinates and data spans
• sensors-latest [--month YYYY-MM] [--search TEXT] [--limit N] [--json] — counts per countline and transport class for the newest published day, with a monthly daily average and explicit stale/missing observations

Notes

• Licence: CC BY 4.0 — attribute "Wellington City Council" (or GWRC for --portal gwrc data; Wellington Water for gis.wellingtonwater.co.nz flood model layers)
• GWRC hazard and climate layers (sea level rise, storm surge, regional flood hazard, Emergencies_P landslide/liquefaction/tsunami, Modelled_Climate_Change) live on mapping1.gw.govt.nz; Wellington Water stormwater flood depth models live on gis.wellingtonwater.co.nz — both are accepted by layers/query
• Searches are scoped to each council's ArcGIS organisation; hub-wide search APIs return a global catalogue and are deliberately not used
• Layer queries require HTTPS, exact declared hosts, and a verified WCC/GWRC ArcGIS organisation id; unrelated global ArcGIS items, malformed service paths, and redirect host changes are refused
• Ordinary query output stays GeoJSON-shaped. --count and --ids-only are mutually exclusive and return JSON envelopes. Paging and precision controls map directly to ArcGIS REST without adding scientific interpretation.
• --fields accepts * or comma-separated field identifiers. --order-by accepts comma-separated field identifiers with optional ASC/DESC. Qualified names may use valid non-empty dotted segments; SQL punctuation, empty segments, and malformed directions are rejected before network access.
• identify is a raw MapServer identify primitive, not a hazard assessment, safety recommendation, or conclusion. Points and bounding boxes are WGS84; non-finite and out-of-range coordinates are refused before network access.
• Invalid arguments, type errors, mutually exclusive modes, blocked sources, and malformed upstream responses use a structured JSON error on stderr.
• sensors-latest downloads the month's count file (~12 MB) — WCC refreshes it at least monthly and in practice daily; expect the newest day to be about one day old
• A missing countline/class row is not assumed to mean zero traffic: latest_date_count is null, stale is true, and latest_observed_date plus the metadata's LATEST date are returned for auditability
• Query responses cap at the server's transfer limit (2000); a truncated flag says when to narrow with --where/--bbox

Resources

• CLI entrypoint: scripts/cli.py
• Contract test: scripts/test_contract.py; smoke test: scripts/smoke_test.py
• Endpoint discovery, org IDs, and S3 layout: references/source-notes.md