Giter Site home page Giter Site logo

whereami's Introduction

WhereAmI

A quick command line tool to get your geographic coordinates using the OS X CoreLocation framework, and optionally get human-readable geolocation data (address, etc.) via the OpenCage API.

Download a zip with the latest version here. As the app is unsigned, on newer versions of Mac OS, you will need to right-click (or control-click) the zip file to open it. See Apple's Knowledge Base for more information.

Usage

Open with Finder to execute, or in the terminal. If it can determine a location, it will output longitude, latitude, accuracy in meters and the time the location was found. WhereAmI tries to get a recent location, and will not display one if it is more than a minute old (to avoid inaccurate results from CoreLocation's cached data). If it cannot get location data, it will quit and print an error message.

Example:

whereami

Output:

Latitude: 45.424807, 
Longitude: -75.699234
Accuracy (m): 65.000000
Timestamp: 2019-09-28, 12:40:20 PM EDT

Geolocation with OpenCage

(Available from version 1.1) Use the -k flag, followed by your OpenCage API key (available here), to get human readable location data.

Example:

whereami -k API_KEY_HERE

Output:

Latitude: 45.424807, 
Longitude: -75.699234
Accuracy (m): 65.000000
Timestamp: 2019-09-28, 12:40:20 PM EDT
111 Wellington St, Ottawa,ON K1A 0A6, Canada

Notes

This is provided on an as-is basis. I make no guarantees or warranties as to its accuracy, stability or compatibility. It should be compatible with Mac OS 10.7 and above. Feel free to do with it as you wish.

Changelog

1.1.0

  • Added support for OpenCage API
  • Updated Xcode project for Xcode 10

1.0.2

  • Fixed missing @autoreleasepool. Shouldn't be any practical changes, but it's good form.

1.0.1

  • WhereAmI will now check if Wi-Fi is not enabled and tell the user such if it can't get location data.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.