goosfraba/gps

A simple wrapper for GPS coordinates

1.0.0 2020-07-08 21:22 UTC

Requires

• php: >=7.1
• webit/bcmath: ^2.0.1

Requires (Dev)

• phpunit/phpunit: ^9.2.5

MIT

• dbojdo

• calculation
• distance
• gps
• coordinates

README

A simple wrapper for GPS coordinates. Provides basic functionalities like distance calculation between two givens points, interpolation of the coordinates between two givens points and antipodes calculation. It uses bcmath PHP extension for calculation (for eligible calculations only).

Installation

Use composer

composer require goosfraba/gps

Usage

Coordinates instantiation and basic usage

use Goosfraba\Gps\GpsCoordinates;
$coordinates = GpsCoordinates::createFromDegrees(38.8, -77.1);
// or
$coordinates = GpsCoordinates::createFromRadians(0.677187749773799875846392, -1.3456488532876281038081655);

// accessing coordinates in radians
$latitudeInRadians = $coordinates->latitudeInRadians();
$longitudeInRadians = $coordinates->longitudeInRadians();

// accessing coordinates in degrees
$latitudeInDegrees = $coordinates->latitudeInDegrees();
$longitudeInDegrees = $coordinates->longitudeInDegrees();

Calculating distance between two givens points

use Goosfraba\Gps\GpsCoordinates;

$coordinate1 = GpsCoordinates::createFromDegrees(51.5, 0);
$coordinate2 = GpsCoordinates::createFromDegrees(38.8, -77.1);

$distanceInMeters = $coordinate1->disntaceTo($coordinate2);

Coordinates interpolation between two givens points at given distance

use Goosfraba\Gps\GpsCoordinates;

$coordinate1 = GpsCoordinates::createFromDegrees(51.5, 0);
$coordinate2 = GpsCoordinates::createFromDegrees(38.8, -77.1);

$midPointCoordinates = $coordinate1->pointBetween($coordinate2);
$coordinatesAt10Percent = $coordinate1->pointBetween($coordinate2, $coordinate1->distanceTo($coordinate2) / 10);

Antipodes calculation

use Goosfraba\Gps\GpsCoordinates;

$coordinate = GpsCoordinates::createFromDegrees(51.5, 0);
$antipodes = $coordinate->antipodes();

Tests

./vendor/bin/phpunit