View on GitHub

Open Location Code

Download this project as a .zip file Download this project as a tar.gz file

Open Location Codes are a way of encoding location into a form that is easier to use than latitude and longitude. They are designed to be used like street addresses, especially in places where buildings aren't numbered or streets aren't named.

Stop giving directions

Instead of giving people complicated directions, just give them a short code that tells them exactly where you want them to go. They can enter it in their phone, laptop, computer, and get the exact location. They don't even need to be online!

Most places just need a six character code and a locality to get an accurate, unique reference. For example, this football pitch in Belo Horizonte, Brazil has the location "Belo Horizonte 22WM+PW". Try it on the demo site!

If you don't want to use the locality, you can use the full 10 character code. That same football pitch has the full reference 58GR22WM+PW. "58GR" is like an area code of a telephone number, and like an area code, if you're in the town (or even near it) you don't need it.

Who are these codes for?

Here are three examples of people who could use these codes.

People living in unmapped slum areas, such as Kibera in Nairobi, could use these codes as a home or business address. For example, the Adventure Crafts Glassmart in Kibera has the address "Stall No.164, Makina Stalls, Kibera Dr, Kibera, Located close to the Toi Market". That's not easy to find, and the glass they ordered might be delivered late if at all. But if they tell the delivery company that their address was "MQPQ+QG Kibera", they can look it up, get the exact location, and the glass will be delivered faster.

Small businesses rely on people being able to find them. This is especially true for guest houses, because they are mostly used by people who are not local to the area. If a guest house provides their location using these codes, a visitor is able to use that code to go directly to the location.

Crisis response organisations need accurate location information. These may be existing buildings (storage warehouses) or things such as wells that don't have addresses, or temporary camps that could be long distances from the nearest road. Latitude and longitude coordinates are long and prone to errors, leading to wasted time and resources. Using short codes that importantly, do not require expensive satellite communications, could provide such organisations with improved location information.

I'm a business, can I use the codes?

Of course. The codes are free to get and free to decode. We've got software libraries on our Github site, and example web pages. If you need help, you can contact the mailing list.

That's so cool! Can I help?

Yes! We are working on implementations in other languages, but if you'd like to do an implementation, contact the mailing list and see if anyone else is already working on the language.

Alternatively, if you know someone who would be interested, let them know.

Why didn't you just use X?

The first thing we did was to work out what attributes of addresses were useful. Once we had that list, we looked at a lot of existing location coding methods to see how well they matched our list. Once we'd done that, we decided that it was worth to at least define a new one, and then see if it was well received.

The other methods were mostly designed with different ideas in mind, and so this isn't a criticism of them.

What makes Open Location Codes different?

Point me to the info!


Open Location Codes were developed at Google's Zurich engineering office, and then open sourced so that they can be freely used. The main author is Doug Rinckes (@drinckes), with the help of lots of colleagues including: