Parchment Docs
UsageIntegrations

Nominatim

Open-source geocoding, search, and place detail via Nominatim.

Nominatim is the geocoding and search engine that powers OpenStreetMap.org. It can be used via the public OSM instance or self-hosted.


Capabilities

CapabilityDescription
SearchPlace text search over OSM data
GeocodingAddress-to-coordinate and reverse geocoding
Place InfoFetch place detail by OSM ID

Configuration

In Settings → Integrations, click the settings icon on the Nominatim card.

FieldValue
HostBase URL of the Nominatim instance. Defaults to https://nominatim.openstreetmap.org (public OSM server). For self-hosted use your instance URL, e.g. http://localhost:8080.

No API key is required for the public OSM instance. Click Test Connection before saving.


Notes

Barrelman outranks Nominatim for geocoding, so when both are configured Nominatim only serves coordinates Barrelman has no data for — which keeps you well inside the public instance's rate limit.

The public Nominatim instance enforces a usage policy — maximum 1 request/second, no bulk geocoding. For production use, self-host Nominatim or use a hosted provider. See nominatim.org for self-hosting instructions.