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

From Geohashing
imported>Sourcerer
m (Source Code and Documentation)
imported>Sourcerer
m (KML Tool)
Line 1: Line 1:
<div style="background-color:#ffaaaa; border: solid 1px; padding:10px;">Double check output - not thoroughly tested yet!</div>
+
<div style="background-color:#ffaaaa; border: solid 1px; padding:10px;">Double check the output - it's not thoroughly tested yet!</div>
  
 
This [http://nbest.co.uk/kmlGeohash/testForm.php calculator] creates a KML file.
 
This [http://nbest.co.uk/kmlGeohash/testForm.php 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.
 
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 ==
 
 
Please put bugs and requests on the [[User talk:Sourcerer/KML tool|discussion tab]].
 
  
 
[[File:Sourcerer KML.jpg]]
 
[[File:Sourcerer KML.jpg]]
  
 +
__TOC__
 
== Usage ==
 
== Usage ==
  
 
Use this [http://nbest.co.uk/kmlGeohash/testForm.php input form] or modify the web address below ...
 
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=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]
+
[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]
  
 
If any URL parameter is omitted, a default value is used instead.
 
If any URL parameter is omitted, a default value is used instead.
Line 23: Line 20:
 
* '''lon''' - your graticule longitude - the default is 0 (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.
 
* '''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.
 +
 +
== Bugs and feature requests ==
 +
 +
Please put bugs and requests on the [[User talk:Sourcerer/KML tool|discussion tab]].
  
 
== Tests ==
 
== Tests ==
Line 39: Line 40:
 
== Source Code and Documentation ==
 
== Source Code and Documentation ==
  
* [https://github.com/nbauers/Geohashing-KML-Calculator Code on GitHub]
+
* [https://github.com/nbauers/Geohashing-KML-Calculator Source on GitHub]
 
* [[Algorithm]]
 
* [[Algorithm]]
 
* [[30W Time Zone Rule]]
 
* [[30W Time Zone Rule]]

Revision as of 21:36, 20 January 2016

Double check the output - it's not thoroughly tested yet!

This calculator creates a KML file.

If 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.

Sourcerer KML.jpg

Usage

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

http://nbest.co.uk/kmlGeohash/index.php?date=2008-05-21&lat=52&lon=0&skins=2

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 - 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.

Bugs and feature requests

Please put bugs and requests on the discussion tab.

Tests

These tests passed on a weekend. On weekdays when the 30W Time Zone Rule rule applies, things are a bit more chaotic.

  • Test equator - Looks OK.
  • Test round the back - The coordinates are shifted to prevent wrapping at +/- 179.999o
  • Australia - Australia looks OK.
  • Atlanta - Atlanta looks OK.
  • North pole - The coordinates are shifted to prevent wrapping at +/- 89.999o
  • South pole - The coordinates are shifted to prevent wrapping at +/- 89.999o
  • -50, -28 - South Georgia and Zavodovski islands look WRONG either side of 30W.
  • -50, -32 - South Georgia and Zavodovski islands look WRONG either side of 30W.

Source Code and Documentation