Nominatim

From IndieWeb


Nominatim is a piece of open source software and a hosted instance based on OpenStreetMap data for geocoding and reverse geocoding, for example deriving coordinates from a physical address or vice versa.

It is a useful service for implementing location-aware applications.

Nominatim interactive UI:

Documentation:

How to

How to get mf2 data from Nominatim

How to derive microformats2 data from Nominatim responses:

Given response data from Nominatim:

  • let adr be the value of the address key in data
  • derive the following microformats2 h-adr/h-geo/h-card properties from adr:
    • street-address from adr.road or null
    • extended-address from adr.suburb or null
    • locality from adr.hamlet or adr.village or adr.town or adr.city or null
    • country-name from adr.country or null
    • postal-code from adr.postcode or null
    • country-code from adr.country_code or null
    • if adr.country_code is 'us':
      • derive region from adr.state or adr.county
      • otherwise: derive region from adr.county or adr.state

IndieWeb Examples

IndieWebCamp Attendees using Nominatim:

  • Tom Morris
  • Barnaby Walters to go from lat/long data to address data in notes with location data/β€œcheckins”
  • David Shanske uses nominatim for reverse lookup, with a fallback on other services, due an occasional lockout.
  • …

See Also