The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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.