Download the PHP package longitude-one/geo-parser without Composer

On this page you can find all versions of the php package longitude-one/geo-parser. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package geo-parser

Geographic parser: longitude-one/geo-parser

longitude-one/geo-parser Stable release Packagist License

Lexer and parser library for geographic coordinate strings.

PHP CI Coverage Status Minimum PHP Version

Downloads

Installation

Current version:

Usage

The parser supports two usage patterns. Pass the value to parse to the constructor, then call parse() on the resulting Parser object:

When parsing many values, reuse a single Parser instance:

Typed coordinates (since 4.0.0)

Since version 4.0.0, use parseAsCoordinates() when the parsed value should retain its coordinate structure. It returns a Coordinate for a single value and a Point for a pair. An axis is set only when the input contains a cardinal direction; otherwise getAxis() returns null.

For example, (new Parser('40, 79'))->parseAsCoordinates() returns a Point whose two coordinates both have a null axis.

Supported Formats

Both single values and coordinate pairs are supported. The following examples illustrate the supported formats; they are not exhaustive.

A numeric sign may accompany a cardinal direction when both agree: +40N, +75E, -40S, and -75W are accepted. The direction is applied once (-75W returns -75); conflicting combinations such as -40N or +75W throw UnexpectedValueException. This also applies to DDM/DMS formats and coordinate pairs, for both parsing methods. Previously rejected signed cardinal inputs are now accepted when consistent (issue #31).

  1. Simple single-signed values

    • 40
    • -40
    • -8.543
    • +132
    • +77.2
  2. Simple single signed values with degree symbol

    • 40°
    • -40°
    • -5.234°
    • +43°
    • +38.43°
  3. Single unsigned values with or without degree symbol, and cardinal direction

    • 40° N
    • 40 S
    • 56.242 E
  4. Single values of signed integer degrees with degree symbol, and decimal minutes with apostrophe

    • 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

    • 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

    • 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

    • +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

    • 40° 26' 46" S
    • 99° 58' 56" W
    • 44° 58' 53.9" N
  9. Single values of unsigned integer degrees with a colon, integer minutes, optional integer or decimal seconds, and a cardinal direction

    • 40:26:46 S
    • 99:58:56 W
    • 44:58:53.9 N
  10. Two of any one format separated by whitespace

  11. Two of any one format separated by a comma

Return

The parser returns an integer or float for a single value, or an array containing a coordinate pair.

String inputs are tokenized and parsed as geographic coordinates. Native integer and float inputs are returned unchanged, including their type, without passing through the lexer or geographic range validation.

Exceptions

Untrusted values in exception messages are formatted by spatial-core's DiagnosticValueFormatter: control characters and invalid UTF-8 bytes are escaped, and each value is limited to 2,048 characters.

Library exceptions thrown by the Lexer and Parser implement the LongitudeOne\GeoParser\Exception\ExceptionInterface interface:

Roadmap

[!NOTE] A major release may increase the minimum supported PHP version. Other breaking changes are documented in the changelog.

Version PHP compatibility Tested on Doctrine Lexer Tested with Lexer Released Active Support Security fix
3 8.1 - 8.2 - 8.3 - 8.4 - 8.5 From 8.1 to 8.5 ^2.1 - ^3.0 2.1 3.0 3.1-xdev 4.0-xdev 04 May 2024 31 August 2026 31 December 2026
4 8.3 - 8.4 - 8.5 8.3 - 8.4 - 8.5 ^3.0.1 3.0 3.1-xdev 4.0-xdev August 2026 31 December 2026 31 December 2027
5 8.4 - 8.5 8.4 - 8.5 3.0 3.1-xdev 4.0-xdev January 2027 31 December 2027 31 December 2028
6 8.5 8.5 3.0 3.1-xdev 4.0-xdev. January 2028 31 December 2028 31 December 2029

PHP versions marked as “tested”, along with every listed Doctrine Lexer version, are part of the continuous integration matrix.

Support Policy

The non-breaking-change guarantee applies only to the Lexer and Parser classes. AxisEnum is provided by the longitude-one/spatial-core dependency. All other classes are internal implementation details and may change or be removed in any release.

Only the latest major version receives feature and bug fixes. Non-security issues will not be addressed during the security-fixes period.

Previous major versions may receive security fixes only, according to the roadmap above.


All versions of geo-parser with dependencies

PHP Build Version
Package Version
Requires php Version ^8.3
doctrine/lexer Version ^3.0
longitude-one/spatial-core Version ^1.1
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package longitude-one/geo-parser contains the following files

Loading the files please wait ...