I’m delighted to share that our geocoder has been integrated into Rob Mather’s Mac command line tool WhereAmI. With WhereAmI Mac users can access geographic coordinates from the OS X CoreLocation service - basically where does the computer think you are. If you supply your OpenCage API key as an optional parameter, those coordinates are then turned into a human readbale location (the formatted string from our API response).

Here’s an example:

$ ./whereami -k abcdefghijklmnopqrstuvxyz123456
Latitude: 41.401360
Longitude: 2.128932
Accuracy (m): 65.000000
Timestamp: 17/10/2019, 12:02:52 CEST
Carrer de Calatrava, 68, 08017 Barcelona, Spain

The fun thing about this is you can now programmatically add your location to things. For example, let’s say you want to add your location to your git commits.

Here’s a step-by-step guide to how you do it and here’s what it then looks like:


I am sure you can come up with many other interesting ideas - when you do please let us know, we will glaldy feature them.

The WhereAmI application is fully open source, and I’m sure Rob welcomes pull requests.


Many thanks to Rob for the integration.

Happy geocoding,