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: @@
-== Bugs and requests ==
+{{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>
-Please put bugs and requests on the [[User talk:Sourcerer/KML tool|discussion tab]].
+This [http://nbest.co.uk/kmlGeohash/testForm.php calculator] creates and downloads KML hashpoint data including the globalhash.
+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.
+[[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 ...
+ [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]
+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 [[User talk:Sourcerer/KML tool|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==
+{| 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]
+|}
+== Source Code and Documentation ==
-* '''date''' - formatted yyyy-mm-dd - the default is today's date.
+* [https://github.com/nbauers/Geohashing-KML-Calculator Source on GitHub]
-* '''lat''' - your graticule latitude - the default is 51 (Grenwich London)'
+* [[Algorithm]]
-* '''lon''' - your graticule longitude - the default is 0 (Grenwich London)'
+* [[30W Time Zone Rule]]
-* '''skins''' - like an onion, the number of layers of points sorrounding the home point - the default is 1 - the limit is 6.
+* [[Implementations#KML_Tool|Implementations KML_Tool]]
 [[Category:Implementations]]