.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "Geo::Point 3pm" .TH Geo::Point 3pm "2019-02-21" "perl v5.28.1" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Geo::Point \- a point on the globe .SH "INHERITANCE" .IX Header "INHERITANCE" .Vb 2 \& Geo::Point \& is a Geo::Shape .Ve .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& use Geo::Point; \& \& my $p = Geo::Point\->latlong(1,2); \& my $p = Geo::Point\->longlat(2,1); \& \& my $w = Geo::Proj\->new(wgs84 => ...); \& my $p = Geo::Point\->latlong(1,2, \*(Aqwgs84\*(Aq); \& \& my ($lat, $long) = $p\->latlong; \& my ($x, $y) = $p\->xy; \& my ($x, $y) = $p\->in(\*(Aqutm31\-wgs84\*(Aq); \& \& my $p = Geo::Point\->xy(1,2); .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" One location on the globe, in any coordinate system. This package tries to hide the maths and the coordinate system in which the point is represented. .PP One of the most confusing things when handling geometrical data, is that sometimes latlong, sometimes xy are used: horizontal and vertical organization reversed. This package tries to hide this from your program by providing abstract accessors \fBlatlong()\fR, \fBlonglat()\fR, \&\fBxy()\fR, and \fByx()\fR. .PP Extends \*(L"\s-1DESCRIPTION\*(R"\s0 in Geo::Shape. .SH "METHODS" .IX Header "METHODS" Extends \*(L"\s-1METHODS\*(R"\s0 in Geo::Shape. .SS "Constructors" .IX Subsection "Constructors" Extends \*(L"Constructors\*(R" in Geo::Shape. .ie n .IP "Geo::Point\->\fBfromString\fR( $string, [$projection] )" 4 .el .IP "Geo::Point\->\fBfromString\fR( \f(CW$string\fR, [$projection] )" 4 .IX Item "Geo::Point->fromString( $string, [$projection] )" Create a new point from a \f(CW$string\fR. The coordinates can be separated by a comma (preferably), or blanks. When the coordinates end on \s-1NSEW,\s0 the order does not matter, otherwise lat-long or xy order is presumed. .Sp This routine is very smart. It understands: .Sp .Vb 11 \& PROJLABEL VALUE VALUE \& PROJLABEL: VALUE VALUE \& PROJLABEL, VALUE, VALUE \& PROJLABEL: VALUE, VALUE \& VALUE VALUE \& VALUE, VALUE \& utm: ZONE, VALUE, VALUE # also without commas and \*(Aq:\*(Aq \& utm: VALUE, VALUE, ZONE # also without commas and \*(Aq:\*(Aq \& utm: VALUE, VALUE # also without commas and \*(Aq:\*(Aq \& ZONE, VALUE, VALUE # also without commas and \*(Aq:\*(Aq \& VALUE, VALUE, ZONE # also without commas and \*(Aq:\*(Aq .Ve .Sp The \s-1VALUE\s0 must be suitable for projection. If only two values are provided, a \f(CW\*(C`d\*(C'\fR, single or double quote, or trailing/leading \f(CW\*(C`e\*(C'\fR, \f(CW\*(C`w\*(C'\fR, \&\f(CW\*(C`n\*(C'\fR, \f(CW\*(C`s\*(C'\fR (either lower or upper-case) will force a latlong projection. Those coordinates must follow the rules of \fBdms2deg()\fR. .Sp example: point from string .Sp .Vb 5 \& my $x = \*(Aqutm 31n 12311.123 34242.12\*(Aq; # utm zone 31N \& my $x = \*(Aq12311.123 34242.12 31\*(Aq; # utm zone 31 \& my $x = \*(Aq123.123E 12.34\*(Aq; # wgs84 latlong \& my $x = \*(Aqclrk66 123.123 12.34\*(Aq; # clrk66 latlong \& my $x = \*(Aq12d34\*(Aq123.1W 11.1123\*(Aq; # wgs84 longlat \& \& my $p = Geo::Point\->fromString($x); \& \& # When parsing user applications, you probably want: \& my $p = eval { Geo::Point\->fromString($x) }; \& warn $@ if $@; .Ve .ie n .IP "$obj\->\fBlatlong\fR( [ $lat,$long,[$proj] ] | [$proj] )" 4 .el .IP "\f(CW$obj\fR\->\fBlatlong\fR( [ \f(CW$lat\fR,$long,[$proj] ] | [$proj] )" 4 .IX Item "$obj->latlong( [ $lat,$long,[$proj] ] | [$proj] )" .PD 0 .ie n .IP "Geo::Point\->\fBlatlong\fR( [ $lat,$long,[$proj] ] | [$proj] )" 4 .el .IP "Geo::Point\->\fBlatlong\fR( [ \f(CW$lat\fR,$long,[$proj] ] | [$proj] )" 4 .IX Item "Geo::Point->latlong( [ $lat,$long,[$proj] ] | [$proj] )" .PD When called as class method, you create a new point. Provide a LATitude and LONGitude. The optional PROJection tells in which coordinate system. .Sp As instance method, the latitude and longitude are reported. You can ask it to be translated into the \f(CW$proj\fR coordinate system first. .Sp When \f(CW$proj\fR is undefined, none is presumed. The project must be specified as string, which referse to a projection defined by Geo::Proj. See also \fBlonglat()\fR, \fBxy()\fR, and \fByx()\fR. .Sp example: latlong as class method .Sp .Vb 2 \& my $wgs84 = Geo::Proj\->new(wgs84 => ...); \& my $gp = Geo::Point\->latlong(52.3213, 5.53, \*(Aqwgs84\*(Aq); .Ve .Sp example: latlong as instance method .Sp .Vb 1 \& my ($lat, $long) = $gp\->latlong(\*(Aqwgs84\*(Aq); .Ve .ie n .IP "$obj\->\fBlonglat\fR( [ $long,$lat,[$proj] ] | [$proj] )" 4 .el .IP "\f(CW$obj\fR\->\fBlonglat\fR( [ \f(CW$long\fR,$lat,[$proj] ] | [$proj] )" 4 .IX Item "$obj->longlat( [ $long,$lat,[$proj] ] | [$proj] )" .PD 0 .ie n .IP "Geo::Point\->\fBlonglat\fR( [ $long,$lat,[$proj] ] | [$proj] )" 4 .el .IP "Geo::Point\->\fBlonglat\fR( [ \f(CW$long\fR,$lat,[$proj] ] | [$proj] )" 4 .IX Item "Geo::Point->longlat( [ $long,$lat,[$proj] ] | [$proj] )" .PD Like \fBlatlong()\fR, but with the coordinates reversed. Some applications prefer this. .ie n .IP "$obj\->\fBnew\fR(%options)" 4 .el .IP "\f(CW$obj\fR\->\fBnew\fR(%options)" 4 .IX Item "$obj->new(%options)" .PD 0 .IP "Geo::Point\->\fBnew\fR(%options)" 4 .IX Item "Geo::Point->new(%options)" .PD .Vb 8 \& \-Option \-\-Defined in \-\-Default \& lat undef \& latitude undef \& long undef \& longitude undef \& proj Geo::Shape see Geo::Proj::defaultProjection() \& x undef \& y undef .Ve .RS 4 .IP "lat => \s-1COORDINATE\s0" 2 .IX Item "lat => COORDINATE" .PD 0 .IP "latitude => \s-1COORDINATE\s0" 2 .IX Item "latitude => COORDINATE" .IP "long => \s-1COORDINATE\s0" 2 .IX Item "long => COORDINATE" .IP "longitude => \s-1COORDINATE\s0" 2 .IX Item "longitude => COORDINATE" .IP "proj => \s-1LABEL\s0" 2 .IX Item "proj => LABEL" .IP "x => \s-1COORDINATE\s0" 2 .IX Item "x => COORDINATE" .IP "y => \s-1COORDINATE\s0" 2 .IX Item "y => COORDINATE" .RE .RS 4 .RE .ie n .IP "$obj\->\fBxy\fR( [$x, $y, [$proj] ] | [$proj] )" 4 .el .IP "\f(CW$obj\fR\->\fBxy\fR( [$x, \f(CW$y\fR, [$proj] ] | [$proj] )" 4 .IX Item "$obj->xy( [$x, $y, [$proj] ] | [$proj] )" .ie n .IP "Geo::Point\->\fBxy\fR( [$x, $y, [$proj] ] | [$proj] )" 4 .el .IP "Geo::Point\->\fBxy\fR( [$x, \f(CW$y\fR, [$proj] ] | [$proj] )" 4 .IX Item "Geo::Point->xy( [$x, $y, [$proj] ] | [$proj] )" .PD Like \fBlonglat()\fR but now for carthesian projections. Usually, the coordinate order is reversed. See also \fByx()\fR. .ie n .IP "$obj\->\fByx\fR( [$y, $x, [$proj] ] | [$proj] )" 4 .el .IP "\f(CW$obj\fR\->\fByx\fR( [$y, \f(CW$x\fR, [$proj] ] | [$proj] )" 4 .IX Item "$obj->yx( [$y, $x, [$proj] ] | [$proj] )" .PD 0 .ie n .IP "Geo::Point\->\fByx\fR( [$y, $x, [$proj] ] | [$proj] )" 4 .el .IP "Geo::Point\->\fByx\fR( [$y, \f(CW$x\fR, [$proj] ] | [$proj] )" 4 .IX Item "Geo::Point->yx( [$y, $x, [$proj] ] | [$proj] )" .PD Like \fBlatlong()\fR but now for carthesian projections. Usually, the coordinate order is reversed. See also \fBxy()\fR. .SS "Attributes" .IX Subsection "Attributes" Extends \*(L"Attributes\*(R" in Geo::Shape. .ie n .IP "$obj\->\fBproj\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBproj\fR()" 4 .IX Item "$obj->proj()" Inherited, see \*(L"Attributes\*(R" in Geo::Shape .ie n .IP "$obj\->\fBproj4\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBproj4\fR()" 4 .IX Item "$obj->proj4()" Inherited, see \*(L"Attributes\*(R" in Geo::Shape .SS "Accessors" .IX Subsection "Accessors" The accessors only work correctly when you are sure that the point is in the right coordinate systems. .ie n .IP "$obj\->\fBlat\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBlat\fR()" 4 .IX Item "$obj->lat()" .PD 0 .ie n .IP "$obj\->\fBlatitude\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBlatitude\fR()" 4 .IX Item "$obj->latitude()" .ie n .IP "$obj\->\fBlong\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBlong\fR()" 4 .IX Item "$obj->long()" .ie n .IP "$obj\->\fBlongitude\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBlongitude\fR()" 4 .IX Item "$obj->longitude()" .ie n .IP "$obj\->\fBx\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBx\fR()" 4 .IX Item "$obj->x()" .ie n .IP "$obj\->\fBy\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBy\fR()" 4 .IX Item "$obj->y()" .PD .SS "Projections" .IX Subsection "Projections" Extends \*(L"Projections\*(R" in Geo::Shape. .ie n .IP "$obj\->\fBin\fR( <$label|'utm'> )" 4 .el .IP "\f(CW$obj\fR\->\fBin\fR( <$label|'utm'> )" 4 .IX Item "$obj->in( <$label|'utm'> )" Inherited, see \*(L"Projections\*(R" in Geo::Shape .ie n .IP "$obj\->\fBnormalize\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBnormalize\fR()" 4 .IX Item "$obj->normalize()" Be sure the that coordinates are between \-180/180 longitude, \-90/90 lattitude. No changes for non-latlong projections. .ie n .IP "$obj\->\fBprojectOn\fR($nick, @points)" 4 .el .IP "\f(CW$obj\fR\->\fBprojectOn\fR($nick, \f(CW@points\fR)" 4 .IX Item "$obj->projectOn($nick, @points)" Inherited, see \*(L"Projections\*(R" in Geo::Shape .SS "Geometry" .IX Subsection "Geometry" Extends \*(L"Geometry\*(R" in Geo::Shape. .ie n .IP "$obj\->\fBarea\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBarea\fR()" 4 .IX Item "$obj->area()" Always returns zero. .ie n .IP "$obj\->\fBbbox\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBbbox\fR()" 4 .IX Item "$obj->bbox()" The bounding box of a point contains twice itself. .ie n .IP "$obj\->\fBbboxCenter\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBbboxCenter\fR()" 4 .IX Item "$obj->bboxCenter()" Inherited, see \*(L"Geometry\*(R" in Geo::Shape .ie n .IP "$obj\->\fBbboxRing\fR( [$xmin, $ymin, $xmax, $ymax, [$proj]] )" 4 .el .IP "\f(CW$obj\fR\->\fBbboxRing\fR( [$xmin, \f(CW$ymin\fR, \f(CW$xmax\fR, \f(CW$ymax\fR, [$proj]] )" 4 .IX Item "$obj->bboxRing( [$xmin, $ymin, $xmax, $ymax, [$proj]] )" .PD 0 .ie n .IP "Geo::Point\->\fBbboxRing\fR( [$xmin, $ymin, $xmax, $ymax, [$proj]] )" 4 .el .IP "Geo::Point\->\fBbboxRing\fR( [$xmin, \f(CW$ymin\fR, \f(CW$xmax\fR, \f(CW$ymax\fR, [$proj]] )" 4 .IX Item "Geo::Point->bboxRing( [$xmin, $ymin, $xmax, $ymax, [$proj]] )" .PD Inherited, see \*(L"Geometry\*(R" in Geo::Shape .ie n .IP "$obj\->\fBdistance\fR( $object, [$unit] )" 4 .el .IP "\f(CW$obj\fR\->\fBdistance\fR( \f(CW$object\fR, [$unit] )" 4 .IX Item "$obj->distance( $object, [$unit] )" Inherited, see \*(L"Geometry\*(R" in Geo::Shape .ie n .IP "$obj\->\fBdistancePointPoint\fR($geodist, $units, $point)" 4 .el .IP "\f(CW$obj\fR\->\fBdistancePointPoint\fR($geodist, \f(CW$units\fR, \f(CW$point\fR)" 4 .IX Item "$obj->distancePointPoint($geodist, $units, $point)" Compute the distance between the current point and some other \f(CW$point\fR in \&\f(CW$units\fR. The \f(CW$geodist\fR object will do the calculations. See \fBdistance()\fR. .ie n .IP "$obj\->\fBinBBox\fR($object)" 4 .el .IP "\f(CW$obj\fR\->\fBinBBox\fR($object)" 4 .IX Item "$obj->inBBox($object)" Returns a true value if this point is inside the bounding box of the specified \f(CW$object\fR. The borders of the bbox are included. This is relatively fast to check, even for complex objects. When the projections differ, the point is translated into the \f(CW$object\fR's coordinate system, because that one must stay square. .ie n .IP "$obj\->\fBperimeter\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBperimeter\fR()" 4 .IX Item "$obj->perimeter()" Always returns zero. .ie n .IP "$obj\->\fBsameAs\fR($other, $tolerance)" 4 .el .IP "\f(CW$obj\fR\->\fBsameAs\fR($other, \f(CW$tolerance\fR)" 4 .IX Item "$obj->sameAs($other, $tolerance)" .SS "Display" .IX Subsection "Display" Extends \*(L"Display\*(R" in Geo::Shape. .ie n .IP "$obj\->\fBcoords\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBcoords\fR()" 4 .IX Item "$obj->coords()" Returns the coordinates in their usual order, formatted as string with a joining blank; .ie n .IP "$obj\->\fBcoordsUsualOrder\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBcoordsUsualOrder\fR()" 4 .IX Item "$obj->coordsUsualOrder()" Returns the coordinates in the order which is usual for the projection used. .ie n .IP "$obj\->\fBdeg2dm\fR($degrees, $pos, $neg)" 4 .el .IP "\f(CW$obj\fR\->\fBdeg2dm\fR($degrees, \f(CW$pos\fR, \f(CW$neg\fR)" 4 .IX Item "$obj->deg2dm($degrees, $pos, $neg)" .PD 0 .ie n .IP "Geo::Point\->\fBdeg2dm\fR($degrees, $pos, $neg)" 4 .el .IP "Geo::Point\->\fBdeg2dm\fR($degrees, \f(CW$pos\fR, \f(CW$neg\fR)" 4 .IX Item "Geo::Point->deg2dm($degrees, $pos, $neg)" .PD Inherited, see \*(L"Display\*(R" in Geo::Shape .ie n .IP "$obj\->\fBdeg2dms\fR($degrees, $pos, $neg)" 4 .el .IP "\f(CW$obj\fR\->\fBdeg2dms\fR($degrees, \f(CW$pos\fR, \f(CW$neg\fR)" 4 .IX Item "$obj->deg2dms($degrees, $pos, $neg)" .PD 0 .ie n .IP "Geo::Point\->\fBdeg2dms\fR($degrees, $pos, $neg)" 4 .el .IP "Geo::Point\->\fBdeg2dms\fR($degrees, \f(CW$pos\fR, \f(CW$neg\fR)" 4 .IX Item "Geo::Point->deg2dms($degrees, $pos, $neg)" .PD Inherited, see \*(L"Display\*(R" in Geo::Shape .ie n .IP "$obj\->\fBdm\fR( [$projection] )" 4 .el .IP "\f(CW$obj\fR\->\fBdm\fR( [$projection] )" 4 .IX Item "$obj->dm( [$projection] )" Like \fBdms()\fR, but doesn't show seconds. .ie n .IP "$obj\->\fBdmHTML\fR( [$projection] )" 4 .el .IP "\f(CW$obj\fR\->\fBdmHTML\fR( [$projection] )" 4 .IX Item "$obj->dmHTML( [$projection] )" Like \fBdmsHTML()\fR, but does not show seconds. .ie n .IP "$obj\->\fBdms\fR( [$projection] )" 4 .el .IP "\f(CW$obj\fR\->\fBdms\fR( [$projection] )" 4 .IX Item "$obj->dms( [$projection] )" Show the point as \s-1DMS\s0 value-pair. You must be sure that the coordinate is a projection for which is it useful to represent the values in \s-1DMS.\s0 In \s-1SCALAR\s0 context, one string is returned. In \s-1LIST\s0 context, the values are returned separately in latlong order. .Sp Be warned, that the returned string may contain single and double quote characters, which may confuse \s-1HTML\s0 (see \fBdmsHTML()\fR). .ie n .IP "$obj\->\fBdms2deg\fR($dms)" 4 .el .IP "\f(CW$obj\fR\->\fBdms2deg\fR($dms)" 4 .IX Item "$obj->dms2deg($dms)" .PD 0 .IP "Geo::Point\->\fBdms2deg\fR($dms)" 4 .IX Item "Geo::Point->dms2deg($dms)" .PD Inherited, see \*(L"Display\*(R" in Geo::Shape .ie n .IP "$obj\->\fBdmsHTML\fR( [$projection] )" 4 .el .IP "\f(CW$obj\fR\->\fBdmsHTML\fR( [$projection] )" 4 .IX Item "$obj->dmsHTML( [$projection] )" Like \fBdms()\fR, but all character which are troublesome for \s-1HTML\s0 are translated into character codes. .ie n .IP "$obj\->\fBmoveWest\fR()" 4 .el .IP "\f(CW$obj\fR\->\fBmoveWest\fR()" 4 .IX Item "$obj->moveWest()" Move a point from the eastern calculations into the western calculations, resulting in a value below \-180. This is useful when this point is part of a larger construct, like the corners of a satellite image, which are both sides of the \-180 meridian. .Sp example: moving West .Sp .Vb 3 \& my $point = Geo::Point\->latlong(24, 179); \& $point\->moveWest; \& print $point\->long; # \-181; .Ve .ie n .IP "$obj\->\fBtoString\fR( [$projection] )" 4 .el .IP "\f(CW$obj\fR\->\fBtoString\fR( [$projection] )" 4 .IX Item "$obj->toString( [$projection] )" Returns a string representation of the point, which is also used for stringification. The default projection is the one of the point. .Sp example: .Sp .Vb 2 \& print "Point: ",$gp\->toString, "\en"; \& print "Point: $gp\en"; # same \& \& print "Point: ",$gp\->toString(\*(Aqclrk66\*(Aq), "\en"; .Ve .SH "OVERLOAD" .IX Header "OVERLOAD" Extends \*(L"\s-1OVERLOAD\*(R"\s0 in Geo::Shape. .ie n .IP "overload: \fB'""""' (stringification)\fR" 4 .el .IP "overload: \fB'``''' (stringification)\fR" 4 .IX Item "overload: '""""' (stringification)" Inherited, see \*(L"\s-1OVERLOAD\*(R"\s0 in Geo::Shape .IP "overload: \fB'bool' (truth value)\fR" 4 .IX Item "overload: 'bool' (truth value)" Inherited, see \*(L"\s-1OVERLOAD\*(R"\s0 in Geo::Shape .SH "DIAGNOSTICS" .IX Header "DIAGNOSTICS" .IP "Error: \s-1UTM\s0 requires 3 values: easting, northing, and zone" 4 .IX Item "Error: UTM requires 3 values: easting, northing, and zone" .PD 0 .IP "Error: can only compare a point to another Geo::Point" 4 .IX Item "Error: can only compare a point to another Geo::Point" .ie n .IP "Error: distance calculation not implemented between a $kind and a $kind" 4 .el .IP "Error: distance calculation not implemented between a \f(CW$kind\fR and a \f(CW$kind\fR" 4 .IX Item "Error: distance calculation not implemented between a $kind and a $kind" .PD Only a subset of all objects can be used in the distance calculation. The limitation is purely caused by lack of time to implement this. .ie n .IP "Error: dms latitude coordinate not understood: $string" 4 .el .IP "Error: dms latitude coordinate not understood: \f(CW$string\fR" 4 .IX Item "Error: dms latitude coordinate not understood: $string" See \fBdms2deg()\fR for permitted formats. .ie n .IP "Error: dms longitude coordinate not understood: $string" 4 .el .IP "Error: dms longitude coordinate not understood: \f(CW$string\fR" 4 .IX Item "Error: dms longitude coordinate not understood: $string" See \fBdms2deg()\fR for permitted formats. .ie n .IP "Error: illegal \s-1UTM\s0 zone in $string" 4 .el .IP "Error: illegal \s-1UTM\s0 zone in \f(CW$string\fR" 4 .IX Item "Error: illegal UTM zone in $string" A \s-1UTM\s0 zone can be detected at the beginning or at the end of the input. It contains a number (from 1 up to 60) and an optional latitude indication (C up to X, except I and O). .ie n .IP "Error: illegal character in x coordinate $x" 4 .el .IP "Error: illegal character in x coordinate \f(CW$x\fR" 4 .IX Item "Error: illegal character in x coordinate $x" .PD 0 .ie n .IP "Error: illegal character in y coordinate $y" 4 .el .IP "Error: illegal character in y coordinate \f(CW$y\fR" 4 .IX Item "Error: illegal character in y coordinate $y" .ie n .IP "Error: \fBin()\fR not implemented for a $class" 4 .el .IP "Error: \fBin()\fR not implemented for a \f(CW$class\fR" 4 .IX Item "Error: in() not implemented for a $class" .ie n .IP "Error: too few values in $string (got @parts)" 4 .el .IP "Error: too few values in \f(CW$string\fR (got \f(CW@parts\fR)" 4 .IX Item "Error: too few values in $string (got @parts)" .PD Most projection require two parameters, but utm requires three (with zone). .ie n .IP "Error: too many values in $string (got @parts)" 4 .el .IP "Error: too many values in \f(CW$string\fR (got \f(CW@parts\fR)" 4 .IX Item "Error: too many values in $string (got @parts)" Most projection require two parameters, but utm requires three (with zone). .ie n .IP "Error: undefined projection $proj for $string" 4 .el .IP "Error: undefined projection \f(CW$proj\fR for \f(CW$string\fR" 4 .IX Item "Error: undefined projection $proj for $string" The projection you used (or is set as default) is not defined. See \&\fBGeo::Proj::new()\fR about how to defined them. .SH "SEE ALSO" .IX Header "SEE ALSO" This module is part of Geo-Point distribution version 0.98, built on February 01, 2019. Website: \fIhttp://perl.overmeer.net/CPAN/\fR .SH "LICENSE" .IX Header "LICENSE" Copyrights 2005\-2019 by [Mark Overmeer]. For other contributors see ChangeLog. .PP This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See \fIhttp://dev.perl.org/licenses/\fR