What3Words is a global grid of 57 trillion 3mx3m squares. Each square has a unique 3 word address that people can find and communicate quickly, easily, and without ambiguity.

Addressing the world

Everyone and everywhere now has an address

Geocoding (3 Words)

>>> import geocoder
>>> g = geocoder.w3w('embedded.fizzled.trial')
>>> g.json

Reverse Geocoding

>>> import geocoder
>>> g = geocoder.w3w([45.15, -75.14], method='reverse')
>>> g.json

Command Line Interface

$ geocode 'embedded.fizzled.trial' --provider w3w
$ geocode '45.15, -75.14' --provider w3w --method reverse

Environment Variables

For safe storage of your API key on your computer, you can define that API key using your system’s environment variables.

$ export W3W_API_KEY=<Secret API Key>


  • location: Your search location you want geocoded.
  • key: use your own API Key from What3Words.
  • method: (default=geocode) Use the following:
    • geocode
    • reverse