geome(1) - Linux man page

Name

geome - Get your location based on wifi signals and your IP address using Google Location

Syntax

geome [-s] [-q] [-h] [-v]

Description

If available, geome queries NetworkManager for its wifi information, such as ESSID's and signal strength, and together with its IP address, sends this information to the Google Location service to obtain your geographic location.

Options

-q / -s

Quiet or Silent mode. Only return latitude and longitude, separated by a comma, on a single line. Without this option, everything that Google returns is displayed, including latitude, longitude, accuracy, address, country, postal code and more.

-h / --help

Output help information and exit.

-v / --version

Output version information and exit.

Requirements

geome works best if it can talk to NetworkManager and obtain a list of nearby Access Points and their strength. If this is unavailable, for instance because NetworkManager is not running, or the computer has no wifi cards, an empty wifi list is sent and Google will return results solely based on the IP address of the request.

Exit Status

geome outputs the location information, if available and exits. The following exit codes are used:

0

Success

1

Network connectivity issues, such as broken DNS or blocked HTTP traffic

2

A captive portal was detected and prevented communication with the Google Location service

3

Unexpected error in the geome python module (contact author)

Bugs

I am sure there are bugs

Authors

This is really a stripped down version of geolocation-cli written by Francis Markham and available at <http://code.google.com/p/geolocate-cli/>.

Mangled by Paul Wouters <pwouters@redhat.com>

Copyright

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. See <http://www.fsf.org/copyleft/gpl.txt>.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License (file COPYING in the distribution) for more details.