User Tools

Site Tools


5wordlocation

5WordLocation

Introduction

In April 2021, I created some software which could represent any location on Earth in just 5 words. The source code is now available on GitHub under the MIT License. I originally created this software as a programming challenge but decided to make it open source so other developers could use it for bigger projects.

Features

Each set of 5 words can identify a unique 123 square metre (1326 square feet) area. This means that there is enough precision to uniquely identify 58 different locations within a 105x68m football pitch.

With just the first 2 words alone, an area of 123 square kilometres can be determined. This is a very large area but it allows the user to identify which country (and often which city) the destination is in. This is a huge advantage over competing software which can't show any location if a word is missing.

The fifth word generated by this software is used entirely as a checksum to ensure none of the previous 4 words were entered incorrectly. This means that the 5th word can actually be omitted if you don't care about verifying the accuracy of the data.

5WL uses a simple word list to generate a sequence of 5 words. It is trivial to edit this list in any way. For example, the list can be replaced with any non-English words to make the software accessible to more people.

Screenshots & Examples

A few days after releasing the original software, I created a web interface which allows 5WordLocation to be used interactively on a map. This interface has since been taken offline.

Here is a screenshot of the web interface being used to look up the words “cent limit musical choice grant” which has the coordinates 40.6893, -74.0445 (The Statue of Liberty)

5WordLocation web interface

The main Python script in the repository prints some locations as an example when executed directly, as shown below:

This script is designed to be included in another, see tests.py and manual.py
Some examples of what this software can do:

51.5013, -0.1419 ---> queen holdem privacy late earn
48.8583, 2.2944 ---> ticket twin featured ball viewing
38.8976, -77.0365 ---> bought keyword cultural wedding whole
37.3317, -122.03 ---> laptop cause format trust hole
27.1751, 78.0421 ---> offering hollow moving step above
41.8901, 12.4922 ---> failed smooth begin nation enjoy
-33.8567, 151.2152 ---> outside trainer practice card loop
-22.9519, -43.2104 ---> told creation double chief loved
29.9791, 31.1342 ---> pyramid sand wrong daily preview
53.8158, -3.0552 ---> slow tower around created argument

Any location on Earth can be represented as 4 words; the 5th word is optional and verifies you didn't make a mistake.
5wordlocation.txt · Last modified: 2021/08/27 15:26 by joseph

Page Tools