shw-geocoder

A minimal PyPI package that wraps the SHSMI address_search geocoding API. THIS PACKAGE IS SPECIFIC TO CERTAIN GEOCODING APIS AND IS NOT UNIVERSAL.

Install

pip install shw-geocoder

For local development:

pip install -e .

Python API

from shw_geocoder import geocode

result = geocode("your-address", "geocoder-url")
print(result["data"][0]["pointX"], result["data"][0]["pointY"])

geocode(address, base, result_count=3) returns the raw JSON returned by the service. When the address cannot be resolved, the payload's count field is 0 and data is empty.

CLI

The package exposes a shw-geocoder command.

Single address

shw-geocoder --base "geocoder-url" \
             --address "your-address"

Prints x, y, accuracy, poi, room_count to stdout.

Batch (CSV in -> CSV out + log)

shw-geocoder --base "geocoder-url" \
             --input  addrs.csv \
             --address-column address \
             --output out.csv \
             --log    run.log

• out.csv keeps every original column from addrs.csv and appends five new columns: x, y, accuracy, poi, room_count. Failed rows leave these blank.
• run.log is a plain-text summary containing start/end time, elapsed seconds, total / success / failed counts, and a breakdown by accuracy value.

Arguments

--address and the --input group are mutually exclusive.