A simple command line tool to help with geocoding country/region ISO 3166-2 codes.

Includes a public domain reference dataset from Natural Earth Data which is stored in GeoParquet format and is accessed with SedonaDB.

python -m pip install giso

giso takes one of two inputs:

• A longitude/latitude coordinate pair. (Decimal degrees in WGS 1984 separated by a comma or a space.) Returns the corresponding ISO 3166-2 code.

giso -122.2483823, 37.8245529
# US-CA

• A valid ISO 3166-2 code. Returns the corresponding geometry as Well-Known Text (WKT).

giso US-CA
# MULTIPOLYGON (((-114.724285 32.712836, -114.764541 32.709839, [...]

Returns None if there are no hits.

giso can also be used as a Python package:

>>> import giso
>>> giso.reverse_geocode(103.8455041, 1.2936855)
'SG-01'
>>> giso.geocode("SG-01")
< POLYGON((103.898 1.305, 103.888 1.301, 103.853 1.277, 103.847 1.272, 103.8 ... >

• Natural Earth Data homepage