OpenStreetMap Nominatim
OpenStreetMap Nominatim is the official geocoding service built on OpenStreetMap (OSM) data, providing free geocoding (converting addresses to geographic coordinates) and reverse geocoding (converting coordinates to human-readable addresses). Nominatim is completely free, requires no API key or account registration, and is maintained as an open-source project that can be self-hosted. For Nigerian developers seeking a cost-free geocoding solution with no vendor lock-in, Nominatim is the go-to choice, particularly for open-source projects, NGO applications, civic tech tools, and early-stage startups without mapping budgets.
The data underlying Nominatim is contributed by the global OpenStreetMap community — a collaborative project similar to Wikipedia where volunteers map the physical world. Nigeria has an active OSM community, and major Nigerian cities (Lagos, Abuja, Port Harcourt, Kano, Ibadan, Enugu) have significant street-level mapping. However, Nigerian OSM coverage is variable — dense urban areas are well-mapped while rural areas and smaller towns may have incomplete data. Applications requiring complete and consistent coverage of all Nigerian locations should supplement Nominatim with Google Maps or another commercial provider for addresses where OSM data is sparse.
The Nominatim Search API geocodes a text query (an address, place name, or search phrase) and returns matching locations with coordinates, structured address components, and OSM object references. A search for "Adeola Odeku Street, Victoria Island, Lagos" returns the coordinates and structured address for that street. Nominatim handles both formal addresses and informal place name searches — querying "Balogun Market Lagos" returns the market's location. The search results include a bounding box useful for map display, an importance score for ranking multiple matches, and the type and class of the matched OSM object (highway, amenity, building, etc.).
Reverse geocoding converts a latitude/longitude coordinate pair to the closest address or place name in the OSM database. Given coordinates from a GPS device, a user's browser, or any other source, Nominatim returns the street address, neighborhood, local government area, state, and country. For Nigerian field data collection applications, IoT deployments, or logistics systems, reverse geocoding translates raw coordinates into meaningful administrative context — identifying not just the address but the local government area (LGA) and state, which is important for Nigerian administrative and regulatory purposes.
Structured address output from Nominatim provides parsed address components — house number, road, suburb, city, state, postcode (where available), country code — as separate fields rather than just a formatted string. This structured output is valuable for Nigerian applications that need to extract specific address components for database storage, validation, or routing to different fulfillment locations based on state or LGA.
The public Nominatim instance at nominatim.openstreetmap.org has a strict rate limit of one request per second and requires a valid HTTP User-Agent header identifying the application making the request. This rate limit makes the public instance unsuitable for high-volume production use — applications sending hundreds or thousands of geocoding requests will be blocked. For production workloads beyond the public limit, there are two options: self-hosting a Nominatim instance, or using one of the many commercial geocoding services that build on OSM data (such as Geoapify, OpenCage, or Pelias) with their own Nominatim instances and higher rate limits.
Self-hosting Nominatim requires downloading the OpenStreetMap data extract for Nigeria (or all of Africa, or the full planet) and running the Nominatim software on a server. The Nigeria extract is relatively small (under 1GB compressed), making it feasible to run on a modest VPS. A self-hosted Nominatim instance has no rate limits, processes all requests locally without internet dependency, and can be tuned for performance. For Nigerian applications with consistent geocoding needs, self-hosting eliminates per-request costs entirely while providing full control over update frequency (OSM data is updated continuously, and self-hosted instances can be updated regularly).
A key advantage of Nominatim for Nigerian civic applications is the OSM ecosystem's open license. OSM data is licensed under the Open Database License (ODbL), which allows free use with attribution requirements. Nigerian NGOs, government agencies, research institutions, and civic tech organizations can use Nominatim data in their applications and publications without commercial licensing concerns, provided they comply with the attribution requirements.