iceaddr

iceaddr - Icelandic Address Geocoding

Python library for Icelandic address lookup, geocoding, and reverse geocoding. Uses a bundled SQLite database from Staðfangaskrá (official address registry).

Install: uv add iceaddr

Address Lookup

from iceaddr import iceaddr_lookup

# By street name and number
results = iceaddr_lookup("Laugavegur", number=22, postcode=101)
# Returns: [{'hnitnum': ..., 'lat_wgs84': 64.1455, 'long_wgs84': -21.9291, ...}]

# Fuzzy search (just street name)
results = iceaddr_lookup("Laugavegur", limit=50)

# With letter suffix
results = iceaddr_lookup("Hlíðarhjalli", number=41, letter="E", postcode=200)

Address Fields

Field	Description
hnitnum	Unique 8-digit location ID
heiti_nf	Street name (nominative)
heiti_tgf	Street name (dative)
husnr	House number
bokst	Letter suffix (a, b, etc)
postnr	Postal code
svfnr	Municipality code
lat_wgs84	Latitude
long_wgs84	Longitude
lysing	Area description
stadur_nf	Place name
svfheiti	Municipality name

Address Autocomplete

from iceaddr import iceaddr_suggest

# Autocomplete as user types
suggestions = iceaddr_suggest("Laugav", limit=10)
# Returns matching addresses sorted by relevance

Reverse Geocoding

from iceaddr import nearest_addr, nearest_addr_with_dist

# Find nearest address to coordinates
lat, lng = 64.1466, -21.9426
addresses = nearest_addr(lat, lng, limit=5)
# Returns: [{'heiti_nf': 'Tjarnargata', 'husnr': 10, ...}]

# With distance in km
results = nearest_addr_with_dist(lat, lng, limit=5)
# Returns: [(address_dict, distance_km), ...]

Placenames

from iceaddr import placename_lookup, nearest_placenames

# Lookup placename
places = placename_lookup("Þingvellir")
# Returns: [{'nafn': 'Þingvellir', 'lat_wgs84': 64.26, 'long_wgs84': -21.12, ...}]

# Find nearest placenames to coordinates
places = nearest_placenames(64.1466, -21.9426, limit=5)