Difference between revisions of "User:Sourcerer/KML tool"

Latest revision as of 08:35, 10 January 2019

Please double check the output - it's been tested but ...

This calculator creates and downloads KML hashpoint data including the globalhash.

If you install Google Earth Desktop or other applications such as Marble that understand this file format, they should launch and display the hashpoints for your specified date and graticule. Surprisingly this worked on my old Android phone. The kml data auto-launched a Google map app and there were the hashpoints with their links to the other tools.

Usage

Use this input form or modify the web address below ...

http://nbest.co.uk/kmlGeohash/index.php?date=2016-01-31&lat=52&lon=-1&clat=52.5&clon=1.5&skins=3

If any URL parameter is omitted, a default value is used instead.

date - formatted yyyy-mm-dd - the default is today's date - alternatively try for example, 1 for tomorrow or -2 for the day before yesterday.
lat - graticule latitude - the default is 51 (Grenwich London) - whole numbers please.
lon - graticule longitude - the default is 0 (Grenwich London) - whole numbers please.
clat - view centre latitude - It's OK to leave this blank.
clon - view centre longitude - It's OK to leave this blank.
skins - like an onion, the number of layers of points surrounding the home point - the default is 1 giving 9 hashpoints - the limits are 0 to 6.
debug - check this or add '&debug=debug' to expose the guts of the algorithm.

Bugs and feature requests

Please put bug reports and feature requests on the discussion tab.

Google earth street view is very useful if your country allows this.
UK geohashers will like the Bing Map (UK OS) link. This shows the hashpoint and rights of way for access.

Tests

2008-05-21 Grenwich Mannheim Australia South Georgia Buenos Aires Atlanta 89,0 89,-30 -89,0 0,0 0,-30 0,179 0,-179	Yesterday Grenwich Mannheim Australia South Georgia Buenos Aires Atlanta 89,0 89,-30 -89,0 0,0 0,-30 0,179 0,-179	Today Grenwich Mannheim Australia South Georgia Buenos Aires Atlanta 89,0 89,-30 -89,0 0,0 0,-30 0,179 0,-179	Tomorrow Grenwich Mannheim Australia South Georgia Buenos Aires Atlanta 89,0 89,-30 -89,0 0,0 0,-30 0,179 0,-179

Source Code and Documentation

@@ Line 1: / Line 1: @@
-<div style="background-color:#ffaaaa; border: solid 1px; padding:10px;">Double check output - not thoroughly tested yet!</div>
+{{30w compliant|yes=1}}
+<span style="background-color:#ffaaaa; border: solid 1px; padding:10px;">Please double check the output - it's been tested but ...</span>
-This calculator creates a KML file.
-If [http://www.google.com/earth/ Google Earth] or another application that understands this file format is installed, it should launch and display the hashpoints for your specified date and graticule.
+This [http://nbest.co.uk/kmlGeohash/testForm.php calculator] creates and downloads KML hashpoint data including the globalhash.
-== Bugs and requests ==
+If you install [https://www.google.com/earth/versions/#earth-pro Google Earth Desktop] or other applications such as [https://marble.kde.org/ Marble] that understand this file format, they should launch and display the hashpoints for your specified date and graticule. Surprisingly this worked on my old Android phone. The kml data auto-launched a Google map app and there were the hashpoints with their links to the other tools.
-Please put bugs and requests on the [[User talk:Sourcerer/KML tool|discussion tab]].
 [[File:Sourcerer KML.jpg]]
+__TOC__
 == Usage ==
-[http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=52&lon=0&skins=2 http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=52&lon=0&skins=2]
+Use this [http://nbest.co.uk/kmlGeohash/testForm.php input form] or modify the web address below ...
-* '''date''' - formatted yyyy-mm-dd - the default is today's date.
+ [http://nbest.co.uk/kmlGeohash/index.php?date=2016-01-31&lat=52&lon=-1&clat=52.5&clon=1.5&skins=3 http://nbest.co.uk/kmlGeohash/index.php?date=2016-01-31&lat=52&lon=-1&clat=52.5&clon=1.5&skins=3]
-* '''lat''' - your graticule latitude - the default is 51 (Grenwich London).
-* '''lon''' - your graticule longitude - the default is 0 (Grenwich London).
-* '''skins''' - like an onion, the number of layers of points surrounding the home point - the default is 1 giving 9 hashpoints - the limits are 0 to 6.
-== Tests ==
+If any URL parameter is omitted, a default value is used instead.
-These tests passed on a weekend. On weekdays when the [[30W Time Zone Rule]] rule applies, things are a bit more chaotic.
+* '''date''' - formatted yyyy-mm-dd - the default is today's date - alternatively try for example, 1 for tomorrow or -2 for the day before yesterday.
+* '''lat''' - graticule latitude - the default is 51 (Grenwich London) - whole numbers please.
+* '''lon''' - graticule longitude - the default is 0 (Grenwich London) - whole numbers please.
+* '''clat''' - view centre latitude - It's OK to leave this blank.
+* '''clon''' - view centre longitude - It's OK to leave this blank.
+* '''skins''' - like an onion, the number of layers of points surrounding the home point - the default is 1 giving 9 hashpoints - the limits are 0 to 6.
+* '''debug''' - check this or add '&debug=debug' to expose the guts of the algorithm.
-* [http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=0&lon=0&skins=6 Test equator] - Looks OK.
+== Bugs and feature requests ==
-* [http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=0&lon=179&skins=6 Test round the back] - The coordinates are shifted to prevent wrapping at +/- 179.999<sup>o</sup>
-* [http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=-33&lon=149&skins=6 Australia] - Australia looks OK.
-* [http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=33&lon=-84&skins=6 Atlanta] - Atlanta looks OK.
-* [http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=89&lon=-0&skins=6 North pole] - The coordinates are shifted to prevent wrapping at +/- 89.999<sup>o</sup>
-* [http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=-89&lon=179&skins=6 South pole] - The coordinates are shifted to prevent wrapping at +/- 89.999<sup>o</sup>
-* [http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=-50&lon=-30&skins=6 -50, -30] - South Georgia and Zavodovski islands look OK either side of 30W.
-== Source Code and Documentation ==
+Please put bug reports and feature requests on the [[User talk:Sourcerer/KML tool|discussion tab]].
-[https://github.com/nbauers/Geohashing-KML-Calculator Source Code] - [[Algorithm]] - [[30W Time Zone Rule]]
+* Google earth street view is very useful if your country allows this.
+* UK geohashers will like the Bing Map (UK OS) link. This shows the hashpoint and rights of way for access.
-[[Category:Implementations]]
+==Tests==
-== Experiments ==
+{| class="wikitable"
+|-
+|
+:'''2008-05-21'''
+:[http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=51&lon=0&skins=2 Grenwich]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=49&lon=8&skins=2 Mannheim]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=-33&lon=149&skins=2 Australia]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=-54&lon=-35&skins=6 South Georgia]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=-34&lon=-58&skins=2 Buenos Aires]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=33&lon=-84&skins=2 Atlanta]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=89&lon=0&skins=2 89,0]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=89&lon=-30&skins=2 89,-30]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=-89&lon=0&skins=2 -89,0]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=0&lon=0&skins=2 0,0]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=0&lon=-30&skins=2 0,-30]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=0&lon=179&skins=2 0,179]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=0&lon=-179&skins=2 0,-179]
+|
+:'''Yesterday'''
+:[http://nbest.co.uk/kmlGeohash/index.php?date=-1&lat=51&lon=0&skins=2 Grenwich]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=-1&lat=49&lon=8&skins=2 Mannheim]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=-1&lat=-33&lon=149&skins=2 Australia]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=-1&lat=-54&lon=-35&skins=6 South Georgia]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=-1&lat=-34&lon=-58&skins=2 Buenos Aires]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=-1&lat=33&lon=-84&skins=2 Atlanta]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=-1&lat=89&lon=0&skins=2 89,0]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=-1&lat=89&lon=-30&skins=2 89,-30]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=-1&lat=-89&lon=0&skins=2 -89,0]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=-1&lat=0&lon=0&skins=2 0,0]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=-1&lat=0&lon=-30&skins=2 0,-30]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=-1&lat=0&lon=179&skins=2 0,179]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=-1&lat=0&lon=-179&skins=2 0,-179]
+|
+:'''Today'''
+:[http://nbest.co.uk/kmlGeohash/index.php?lat=51&lon=0&skins=2 Grenwich]
+:[http://nbest.co.uk/kmlGeohash/index.php?lat=49&lon=8&skins=2 Mannheim]
+:[http://nbest.co.uk/kmlGeohash/index.php?lat=-33&lon=149&skins=2 Australia]
+:[http://nbest.co.uk/kmlGeohash/index.php?lat=-54&lon=-35&skins=6 South Georgia]
+:[http://nbest.co.uk/kmlGeohash/index.php?lat=-34&lon=-58&skins=2 Buenos Aires]
+:[http://nbest.co.uk/kmlGeohash/index.php?lat=33&lon=-84&skins=2 Atlanta]
+:[http://nbest.co.uk/kmlGeohash/index.php?lat=89&lon=0&skins=2 89,0]
+:[http://nbest.co.uk/kmlGeohash/index.php?lat=89&lon=-30&skins=2 89,-30]
+:[http://nbest.co.uk/kmlGeohash/index.php?lat=-89&lon=0&skins=2 -89,0]
+:[http://nbest.co.uk/kmlGeohash/index.php?lat=0&lon=0&skins=2 0,0]
+:[http://nbest.co.uk/kmlGeohash/index.php?lat=0&lon=-30&skins=2 0,-30]
+:[http://nbest.co.uk/kmlGeohash/index.php?lat=0&lon=179&skins=2 0,179]
+:[http://nbest.co.uk/kmlGeohash/index.php?lat=0&lon=-179&skins=2 0,-179]
+|
+:'''Tomorrow'''
+:[http://nbest.co.uk/kmlGeohash/index.php?date=1&lat=51&lon=0&skins=2 Grenwich]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=1&lat=49&lon=8&skins=2 Mannheim]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=1&lat=-33&lon=149&skins=2 Australia]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=1&lat=-54&lon=-35&skins=6 South Georgia]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=1&lat=-34&lon=-58&skins=2 Buenos Aires]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=1&lat=33&lon=-84&skins=2 Atlanta]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=1&lat=89&lon=0&skins=2 89,0]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=1&lat=89&lon=-30&skins=2 89,-30]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=1&lat=-89&lon=0&skins=2 -89,0]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=1&lat=0&lon=0&skins=2 0,0]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=1&lat=0&lon=-30&skins=2 0,-30]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=1&lat=0&lon=179&skins=2 0,179]
+:[http://nbest.co.uk/kmlGeohash/index.php?date=1&lat=0&lon=-179&skins=2 0,-179]
+|}
-* &#x007B;{#dow:2008|05|21}} -> {{#dow:2008|05|21}}
+== Source Code and Documentation ==
+* [https://github.com/nbauers/Geohashing-KML-Calculator Source on GitHub]
+* [[Algorithm]]
+* [[30W Time Zone Rule]]
+* [[Implementations#KML_Tool|Implementations KML_Tool]]
-* &#x007B;{#md5:2008-05-21-&#x007B;{#dow:2008|05|21}}|1|1}} -> {{#md5:2005-08-21-{{#dow:2008|05|21}}|1|1}}
+[[Category:Implementations]]
-* &#x007B;{#md5:2008-05-21-&#x007B;{#dow:2008|05|21}}|2|1}} -> {{#md5:2005-08-21-{{#dow:2008|05|21}}|2|1}}