NAME

Location::GeoTool::Direction - Perl extention to handle direction/distance

SYNOPSIS

use Location::GeoTool;

# Create
$locobj = Location::GeoTool->create_coord('353924.491','1394010.478','wgs84','dmsn');
$dirobj = $locobj->direction_point('403614.307','1410133.022','wgs84','dmsn');

# Fields
$dir = $dirobj->direction;        # 11.8035750... [¡ë]
$dist = $dirobj->distance;        # 561836.65713... [m]
$start = $dirobj->from_point;     # '353924.491','1394010.478','wgs84','dmsn'¤Î
                                    Location::GeoTool¥ª¥Ö¥¸¥§¥¯¥È
$end = $dirobj->to_point;         # '403614.307','1410133.022','wgs84','dmsn'¤Î...

# Methods
$revobj = $dirobj->reverse;       # »ÏÅÀ <-> ½ªÅÀ
$midpoint = $dirobj->pivot(0,0.5);# ÃæÅÀ
$dirstr = $dirobj->dir_string(4,'jp');
                                  # ¡ÖËÌ¡×

DESCRIPTION

Create

Created by methods of Location::GeoTool.

$dirobj = $locobj->direction_point('403614.307','1410133.022','wgs84','dmsn');
$dirobj = $locobj->direction_point($another_locobj);
$dirobj = $locobj->direction_vector(120,500);

Fields

Startpoint, Endpoint, diretion, distance is the fields of this object.

from_point

Return the Startpoint as Location::GeoTool object.

to_point

Return the Endpoint as Location::GeoTool object.

direction

Return the direction from Standpoint to Endpoint by degree between 0 and 360. Start from North (0) and East is positive.

distance

Return the distance between Startpoint to Endpoint, by [m].

Methods

reverse

Return a new Location::GeoTool::Direction object which reverse Startpoint to Endpoint, Endpoint ... and so on.

pivot

$newobj = $dirobj->pivot($rot,$pow);

Return a new Location::GeoTool::Direction object, which is rotate around Startpoint and extend distance $pow times powered.

dir_string

$dirstr = $dirobj->dir_string($denom,$lang);

Return the direction name of direction. $denom specifies the all number of direction names. (4,8,16,32) $lang is the language of name. ('jp','en')

Example of $denom:

In case $dirobj->direction => 241

$dirobj->dir_string(4,'en')  => 'W'
$dirobj->dir_string(8,'en')  => 'SW'
$dirobj->dir_string(16,'en') => 'WSW'
$dirobj->dir_string(32,'en') => 'SWbW'

Character code of Japanese is EUC.

DEPENDENCIES

Math::Trig

SEE ALSO

Support this module in Kokogiko web site : http://kokogiko.net/

AUTHOR

OHTSUKA Ko-hei, <nene@kokogiko.net>

COPYRIGHT AND LICENSE

Copyright (C) 2004-2007 by Kokogiko!,

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

cpanm Location::GeoTool

perl -MCPAN -e shell
install Location::GeoTool