User:Relet/Shmulik

This implementation IS FULLY 30W-compliant.

This page describes the geohashing module of the Phenny IRC bot, which currently runs as user "Shmulik" on the #geohashing IRC channel.

• He can provide you with geohashing related information lookups.
• He notifies the channel of important recent changes.

He understands the following commands:

.# [location [date]] 
returns the geohash (or globalhash) for the given place and date, and a location .lookup for this place. 
Parameters in square brackets are optional. This method is also triggered by the publication of new 
coordinates by zbot, supplementing its information with the matching globalhashes.
location: A string describing a graticule or populated place, or the string "global" for globalhashes. 
It will try to identify the name using the list of all graticules, and http://geonames.org. 
Defaults to the current globalhash if omitted. If the location name contains spaces, replace these by a '+'
date: A date in the ISO format yyyy-mm-dd. Defaults to a current date (for some time zones) if omitted.

.where's location
returns the corresponding graticule name and coordinates for the given search term. If the location is not 
found in the graticule database, it may suggest places from the geonames database and provide their 
coordinates.
location: A pair of coordinates, separated with a space and/or a comma. Alternatively, the name of a 
graticule. Alternatively, the name of any populated place. 

.lookup lat,lon
returns a human readable, hierarchical identification of the given coordinates. The output may vary, 
from a mere country code to street-level details, depending on the available information.
lat,lon: The latitude and longitude of a location, separated by a space and/or a comma.

.[un]register location
registers your nickname for automatic geohash notifications whenever zbot publishes the coordinates. They 
will be sent to you as coordinates, street address and a link via private message.
location: Either a pair of coordinates, a graticule name, or any other place. In the latter case, 
you will un/register for the graticule the place is detemined to be in.

.rcwatch
Runs the RecentChanges watch daemon, if it is not running already.

.stopwatch
Sets a flag that stops the RecentChanges watch daemon before its next update cycle.

.addwatch tag=regex
Adds a new regular expression to the notification list. If the title, comment, or author of a recent change 
match the regular expression, a notification labeled with "tag" will be sent to the IRC channel. This 
command only works in public channels.

.watchlist
Displays the current list of notifications, and their numbers. This command should be used in a private 
message preferably, as it will return the whole list.

.rmwatch number'
Removes a notification from the watchlist. Number is the rule index provided by the .watchlist command.

Examples

relet: .# San+Francisco 2008-05-22
Shmulik: Geohash for San Francisco, United States on 2008-05-22 is: 37.972874275358, -122.238696518558. http://geohash.org/9qc042u2pbvd
Shmulik: Location: Alhambra Valley Rd, Contra Costa, California, US - distance: 0.11km.

relet: .where's Paris
Shmulik: There's Paris, Texas at 33,-95. http://geohashing.org/33,-95
Shmulik: There's Paris, France at 48,2. http://geohashing.org/48,2

relet: .lookup 52.5785927440891,13.8874053955078
Shmulik: Location: Earth, Europe, Germany, Brandenburg, Strausberg.

relet: .addwatch A new report on Main Page?=Template:Expedition Images/
Shmulik: Notification installed. tag 'A new report on Main Page?' = pattern 'Template:Expedition Images/'

Shmulik: New page: File talk:2010011233-81LM02.JPG was created by Reinhard. (65+x)

The code for this module is available in the python geohashing toolshed at http://relet.net/trac/pygeohashing - it has various dependencies though.