creof/geo-parser

Parser for geography coordinate strings

creof/geo-parser

, _(*1)

Lexer and parser library for geometric and geographic point string values., _(*2)

Usage

There are two use patterns for the parser. The value to be parsed can be passed into the constructor, then parse() called on the returned Parser object:, _(*3)

$input  = '79°56′55″W, 40°26′46″N';

$parser = new Parser($input);

$value = $parser->parse();

If many values need to be parsed, a single Parser instance can be used:, _(*4)

$input1 = '56.242 E';
$input2 = '40:26:46 S';

$parser = new Parser();

$value1 = $parser->parse($input1);
$value2 = $parser->parse($input2);

Supported Formats

Both single values and pairs are supported. Some samples of supported formats are below, though not every possible iteration may be explicitly specified:, _(*5)

1. Simple single signed values, _(*6)

   • 40
   • -40
   • -8.543
   • +132
   • +77.2

2. Simple single signed values with degree symbol, _(*7)

   • 40°
   • -40°
   • -5.234°
   • +43°
   • +38.43°

3. Single unsigned values with or without degree symbol, and cardinal direction, _(*8)

   • 40° N
   • 40 S
   • 56.242 E

4. Single values of signed integer degrees with degree symbol, and decimal minutes with apostrophe, _(*9)

   • 40° 26.222'
   • -65° 32.22'
   • +165° 52.22'

5. Single values of unsigned integer degrees with degree symbol, decimal minutes with apostrophe, and cardinal direction, _(*10)

   • 40° 26.222' E
   • 65° 32.22' S

6. Single values of signed integer degrees with degree symbol, integer minutes with apostrophe, and optional integer or decimal seconds with quote, _(*11)

   • 40° 26' 46"
   • -79° 58' 56"
   • 93° 19' 25.8"
   • +120° 19' 25.8"

7. Single values of signed integer degrees with colon symbol, integer minutes, and optional colon and integer or decimal seconds, _(*12)

   • +40:26:46
   • -79:58:56
   • 93:19:25.8

8. Single values of unsigned integer degrees with degree symbol, integer minutes with apostrophe, optional integer or decimal seconds with quote, and cardinal direction, _(*13)

   • 40° 26' 46" S
   • 99° 58' 56" W
   • 44° 58' 53.9" N

9. Single values of unsigned integer degrees with colon symbol, integer minutes with, optional colon and integer or decimal seconds, and cardinal direction, _(*14)

   • 40:26:46 S
   • 99:58:56 W
   • 44:58:53.9 N

10. Two of any one format separated by whitespace, _(*15)

11. Two of any one format separated by a comma, _(*16)

Return

The parser will return a integer/float or an array containing a pair of these values., _(*17)

Exceptions

The Lexer and Parser will throw exceptions implementing interface CrEOF\Geo\String\Exception\ExceptionInterface., _(*18)