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: @@
-This calculator creates a KML file.
+{{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>
-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.
-== Bugs and requests ==
+This [http://nbest.co.uk/kmlGeohash/testForm.php calculator] creates and downloads KML hashpoint data including the globalhash.
-Please put bugs and requests on the [[User talk:Sourcerer/KML tool|discussion tab]].
+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 ...
-* '''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).
+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 ==
+==Tests==
-* [http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=0&lon=0&skins=6 Test equator] - Looks OK.
+{| class="wikitable"
-* [http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=0&lon=179&skins=6 Test round the back] - Partial failure but Google Earth does not display the faulty pins.
+|-
-* [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.
+:'''2008-05-21'''
-* [http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=89&lon=-0&skins=6 North pole] - Partial failure but Google Earth does not display the faulty pins.
+:[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=-89&lon=179&skins=6 South pole] - Partial failure but Google Earth does not display the faulty pins.
+:[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=-50&lon=-30&skins=6 -50, -30] - South Georgia and Zavodovski islands look OK either side of 30W.
+:[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 ==
+== Source Code and Documentation ==
-[http://nbest.co.uk/kmlGeohash/source.php Source Code]
+* [https://github.com/nbauers/Geohashing-KML-Calculator Source on GitHub]
+* [[Algorithm]]
+* [[30W Time Zone Rule]]
+* [[Implementations#KML_Tool|Implementations KML_Tool]]
 [[Category:Implementations]]