/ 
Geo-Coordinates-KKJ-0.01
River stage zero No dependents
/ Geo::Coordinates::KKJ

NAME

Geo::Coordinates::KKJ - converts Finnish Coordinate System from/to WGS84 coordinate system

SYNOPSIS

use Geo::Coordinates::KKJ;

# KKJ Basic Coordinate System to WGS84 coordinates
my ( $lat, $lon ) = KKJxy_to_WGS84lalo('6717563', '2545107');

# WGS84 coordinates to KKJ Basic Coordinate System
my ( $x, $y ) = WGS84lalo_to_KKJxy('60.22543759', '24.85437044');

DESCRIPTION

This module converts WGS84 coordinate system to/from KKJ Basic Coordinate System (in Finnish 'Peruskoordinaatisto')

For more information about the Finnish coordinate system please visit http://www.kolumbus.fi/eino.uikkanen/geodocsgb/ficoords.htm

The Perl module has been adapted from a Python module from Olli Lammi http://aapo.rista.net/tmp/coordinates.py Olli's module is in turn based on Matti Aarnio's work http://www.viestikallio.fi/tools/kkj-wgs84.php?LANG=en

Precision

The transformation might contain a precision error of about 0.5m - 2m

FUNCTIONS

KKJxy_to_WGS84lalo(x, y)
Transforms KKJ Basic Coordinate System to WGS84 coordinates
WGS84lalo_to_KKJxy(lat, lon)
Transforms WGS84 coordinates to KKJ Basic Coordinate System
KKJxy_to_KKJlalo(x, y)
Transforms from KKJ Basic Coordinate System to KKJ geographic coordinates
KKJlalo_to_KKJxy(lat, lon)
Transforms from KKJ geographic coordinates to KKJ Basic Coordinate System
KKJlalo_to_WGS84lalo(lat, lon)
Transforms KKJ geographic coordinates to WGS84 coordinates
WGS84lalo_to_KKJlalo(lat, lon)
Transforms from WGS84 coordinates to KKJ geographic coordinates
KKJ_Zone_I(y)
Determines the correct KKJ-grid zone
KKJ_Zone_Lo(lon)
Determine the zonenumber from KKJ easting
takes KKJ zone which has center meridian
longitude nearest (in math value) to
the given KKJ longitude

SEE ALSO

Good explanation about the finnish coordinate system and its history http://www.kolumbus.fi/eino.uikkanen/geodocsgb/ficoords.htm (in English)

Transforming between different coordinate systems http://kansalaisen.karttapaikka.fi/koordinaatit/koordinaatit.html?lang=en

AUTHOR

Josep Roca, <quelcom@gmail.com>

COPYRIGHT AND LICENSE

Copyright (C) 2010 by Josep Roca

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.1 or, at your option, any later version of Perl 5 you may have available.