Difference between revisions of "Implementations/Web services"

From Geohashing
imported>Relet
(Created page with "== Text Messaging (email) service == {{30w compliant|yes=1}} If your cell phone supports text messaging to an email address, you can get geohash updates on your phone by sending ...")
 
 
(25 intermediate revisions by 5 users not shown)
Line 1: Line 1:
== Text Messaging (email) service ==
+
=== DJIA sources ===
 +
See: [[Dow Jones Industrial Average]] for a list of data sources for the DJIA openings.
 +
 
 +
=== RSS/Atom ===
 +
==== Phyzome's feed ====
 
{{30w compliant|yes=1}}
 
{{30w compliant|yes=1}}
If your cell phone supports text messaging to an email address, you can get geohash updates on your phone by sending a formatted text to srv@geohash.info
+
Subscribe to a feed that updates as soon as each day's meetup is calculable for your graticule:
=== Formatting ===
+
https://lab.brainonfire.net/geohash.info/srv/feed.php?lat=LAT&lon=LON
YYYY-MM-DD Lat Lon
 
Example:
 
<pre>2008-02-18 42 -83</pre>
 
Alternatively, it defaults to the current date (EST for now) and you can just enter Latitude and Longitude
 
<pre>42 -83</pre>
 
 
 
=== Bugs ===
 
* The [[-0 Issue]] is still very much an issue.
 
* This used to display the degree symbol after coordinate elements, but due to poor cell phone support of this character, which resulted in messages cutting off after the first Latitude, I have removed it.
 
* This is also not a terribly robust solution, but a better (stronger, faster) implementation is in the making.
 
* Not necessarily a bug, but a desirable feature: it would be nice to be able to omit the '-' character when specifying the date (it just happens to require many keystrokes to type - on my phone)
 
 
 
  
== Text Messaging service (SMS) ==
+
If you [https://lab.brainonfire.net/geohash.info/srv/feed.php visit the URL with no parameters], you will be prompted for your graticule coordinates.
{{30w compliant|yes=1}}
 
Text "GH [date]" to +41774378210, eg:
 
<pre>gh 20091110</pre>
 
A few seconds later you should get an sms response similar to the following:
 
<pre>Relevant DJIA for 2009-11-10 is 10223.01(W) / 10020.62(E). Decimal parts are: 0.02335 0.228005(W) / 0.854495 0.149983(E).</pre>
 
  
Occasionally you may see a result of '''<n/a>''' when information is unavailable. For example, if you are looking at a date where coordinates are only available east of w30, you may see something like:
+
* Dow data comes from the [[Dow#carabiner.peeron.com|peeron service]]
<pre>Relevant DJIA for 2009-11-10 is <n/a>(W) / 10020.62(E). Decimal parts are: <n/a>(W) / 0.854495 0.149983(E).</pre>
+
* To view source, drop the parameters and change the extension to .phps -- this currently works for all PHP files in geohash.info/srv/
  
Not case-sensitive, so "Gh", "gh" etc. are all fine. Don't forget the space between "gh" and the date. The script is also flexible on the date format as long as it's in the Y-m-d order.
+
;Quirks
 +
* The script estimates your timezone based upon your longitude, and uses -04:30 as the timezone of the Dow. Therefore, the update times may be off by as much as an hour or two. Shouldn't be an issue, since they'll be around midnight for most people.
 +
* For non-30W users, the feed will be empty between midnight and 9:30 AM -- this should be acceptable, since most feed readers keep entries that have dropped off the end of the feed. (This behavior may be changed in the future.)
  
The service uses the [[Dow_Jones_Industrial_Average#geo.crox.net|DJIA source]] that I maintain.
+
==== Geo Hashing RSS ====
 +
{{30w compliant|yes=2}}
 +
Another RSS implementation, coded by [[User:Mattyk|Matty K]].  This one simply provides a graticule's coordinates for a given day, and gives links to both Google maps and the peeron maplet.  It is recalculated at every request (so please don't hammer it, or my website will run out of bandwidths).
 +
http://geohashing.kerwin.net.au/rss.php?ll=LAT,LON
 +
For example, the link for [[San Francisco, California|San Francisco]]'s feed is: http://geohashing.kerwin.net.au/rss.php?ll=37,-122
  
I recommend testing it once before you are away from home and really need it. Also, don't hesitate to tell me if you don't get an sms back or if you feel that something else is not working properly...
+
Notes:
 +
* If latitude/longitude are not given, it defaults to [[Townsville, Australia|my home graticule]] .
 +
* <s>I don't know if it supports negative zero.  If there is a request to add specific support, please [mailto:matthew@kerwin.net.au?subject=Geo+Hashing+RSS let me know].</s>  I added specific negative zero support, and tested it with the London area.  It appeared to work okay.
 +
* [[30W Time Zone Rule|30W]]-compliance is based on the fact that I live East of 30W, and it gives me the right coordinates each day.
 +
* For any bug reports or other features requests, please [mailto:matthew@kerwin.net.au?subject=Geo+Hashing+RSS email Matty]
 +
* Sources can be made available by request. Although [[User:Mattyk|Matty]] might be a little ashamed of the shoddy code.
  
See also [[Dow Jones Industrial Average#SMS|SMS DJIA service]]; suggestions, comments and other feedback to [[User:Crox]].
+
== Automatic Daily Notifications ==
 +
After registering, it will automatically notify users about all hashpoints as soon as they become available.  Graticules are divided into 100 sub-graticules to allow users to only be notified when a hashpoint is near home, or alternatively, for all accessible hashpoints in a graticule.  For more information, see the [[User:Aperfectring/Notification|program's page]].
 +
[[Category:Implementations]]

Latest revision as of 18:54, 14 January 2022

DJIA sources

See: Dow Jones Industrial Average for a list of data sources for the DJIA openings.

RSS/Atom

Phyzome's feed

This implementation IS FULLY 30W-compliant.

Subscribe to a feed that updates as soon as each day's meetup is calculable for your graticule:

https://lab.brainonfire.net/geohash.info/srv/feed.php?lat=LAT&lon=LON

If you visit the URL with no parameters, you will be prompted for your graticule coordinates.

  • Dow data comes from the peeron service
  • To view source, drop the parameters and change the extension to .phps -- this currently works for all PHP files in geohash.info/srv/
Quirks
  • The script estimates your timezone based upon your longitude, and uses -04:30 as the timezone of the Dow. Therefore, the update times may be off by as much as an hour or two. Shouldn't be an issue, since they'll be around midnight for most people.
  • For non-30W users, the feed will be empty between midnight and 9:30 AM -- this should be acceptable, since most feed readers keep entries that have dropped off the end of the feed. (This behavior may be changed in the future.)

Geo Hashing RSS

This implementation IS FULLY 30W-compliant.

Another RSS implementation, coded by Matty K. This one simply provides a graticule's coordinates for a given day, and gives links to both Google maps and the peeron maplet. It is recalculated at every request (so please don't hammer it, or my website will run out of bandwidths).

http://geohashing.kerwin.net.au/rss.php?ll=LAT,LON

For example, the link for San Francisco's feed is: http://geohashing.kerwin.net.au/rss.php?ll=37,-122

Notes:

  • If latitude/longitude are not given, it defaults to my home graticule .
  • I don't know if it supports negative zero. If there is a request to add specific support, please let me know. I added specific negative zero support, and tested it with the London area. It appeared to work okay.
  • 30W-compliance is based on the fact that I live East of 30W, and it gives me the right coordinates each day.
  • For any bug reports or other features requests, please email Matty
  • Sources can be made available by request. Although Matty might be a little ashamed of the shoddy code.

Automatic Daily Notifications

After registering, it will automatically notify users about all hashpoints as soon as they become available. Graticules are divided into 100 sub-graticules to allow users to only be notified when a hashpoint is near home, or alternatively, for all accessible hashpoints in a graticule. For more information, see the program's page.