Building high-perf geocoding micro-service with Golang and Redis.

Data flow of geo-coding microservice

Geocoding is the process of transforming a description of a location — such as a pair of coordinates, an address, or a name of a place — to a location on the earth’s surface. At large most startups (except hyperlocal) need resolution upto the city level. Using third-party service to resolve sparse locations is ineffective, expensive, and creates a dependency on tech and business.

This post aims to provide a proven (implemented in GreedyGame) and quick approach to build scalable micro-service to resolve latitude+longitude to city.

With the investment of few hours, an engineer can implement the ability to resolve the inbound traffic’s city without creating dependency on 3rd party.

The entire service includes the following stack:

Redis as Geospatial DB

Redis provides a native implementation for geospatial data-storage which will be used to store and query latitude/longitude for cities. Explaining Geoadd and Georadius below:

Command: GEOADD

redis> GEOADD idx:cities 77.22445 28.63576 "1261481:New Delhi:IN" 
(integer) 1
redis> GEOADD idx:cities 80.92313 26.83928 "1264733:Lucknow:IN"
(integer) 1


redis> GEORADIUS idx:cities 77.227321 28.612912 200 km
1) "1261481:New Delhi:IN"


The key for the geospatial set will be lat-lon, where as the value could be the combination of <GeoNameId>+<CityName>+<CountryId>. This merging of information within values safe additional lookup.

Golang for micro-service

The code uses go-gin as micro-service framework and redigo as Redis client.

Code Structure

Code structure has been modularised as

API call

GET /resolve/{country-code}/{latitude},{longitude}

curl ",77.227321"
"city": "New Delhi",
"country": "IN",
"geonameId": "1261481"
} as data-source

The source is from the geographical database. It covers all countries and contains over eleven million placenames that are available for download free of charge. The data structure is well documented here and available for free to use.

Performance and benchmark

Links and resource

Code, arts, process and aspirations. co-Founded GreedyGame | IIT Ropar. Found at