view release on metacpan or  search on metacpan

lib/Geo/Coordinates/ETRSTM35FIN.pm  view on Meta::CPAN

=over 8

=item ETRSTM35FINxy_to_WGS84lalo(x, y)

    Transforms ETRS-TM35FIN coordinates (x = northing, y = easting) to WGS84
    coordinates.
    
    Returns WGS84 latitude and longitude in a two-value array (latitude,
    longitude). If the given ETRS coordinates are out of defined bounds
    (see is_defined_ETRSTM35FIN) the return values are undefined.

=item WGS84lalo_to_ETRSTM35FINxy(lat, lon)

    Transforms WGS84 coordinates to ETRS-TM35FIN coordinates.
    
    Returns transformed coordinates in a two-value array (x = northing,
    y = easting). If the given WGS84 values are out of the defined bounds
    (see is_defined_WGS84lalo) the return values are undefined.

=item is_defined_ETRSTM35FINxy(x, y)

    Checks whether given ETRS-TM35FIN coordinates (x = northing, y = easting)
    are in the area where the ETRS-TM35FIN coordinate system is defined. The
    boundaries are defined in L<http://spatialreference.org/ref/epsg/3067/>.
    
    Returns true if the coordinates are in the defined area, otherwise false.

=item is_defined_WGS84lalo(lat, lon)

    Checks whether given WGS84 coordinates are in the area where the
    ETRS-TM35FIN coordinate system is defined. The boundaries are defined
    in L<http://spatialreference.org/ref/epsg/3067/>.

    Returns true if the coordinates are in the defined area, otherwise false.

=back

=head1 BUGS

Please report to author.

=head1 SEE ALSO

Official ETRS-TM35FIN definition
L<http://www.jhs-suositukset.fi/web/guest/jhs/projects/jhs154> (in Finnish).
The conversion functions are in appendix 1.

Good explanation about the Finnish coordinate system and its history
L<http://www.kolumbus.fi/eino.uikkanen/geodocsgb/ficoords.htm>.

On-line transformations between different coordinate systems
L<http://kansalaisen.karttapaikka.fi/koordinaatit/koordinaatit.html?lang=en>.

Former Finnish coordinate system conversion routines B<Geo::Coordinates:KKJ>.

=head1 AUTHOR

Perl port and CPAN package Matti Lattu, <matti@lattu.biz>

The conversion formulae have been acquired from a Python module from Olli Lammi
L<http://olammi.iki.fi/sw/fetch_map/>.

=head1 ACKNOWLEDGEMENTS

The Perl realization follows closely Geo::Coordinates::KKJ by Josep Roca.

Thanks for GIS specialist PhD Tuuli Toivonen (University of Helsinki) for her
essential support.

=head1 LICENSE AND COPYRIGHT

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.

Copyright (C) 2010-2011 Olli Lammi and Matti Lattu

=cut