rkondratuk/geo-math-php

Geo calculations library

1.0.1 2025-10-04 15:19 UTC

Requires

• php: >=5.4

Requires (Dev)

• phpunit/phpunit: 5.7.18

MIT

• Roman Kondratuk

• geo
• mathematics
• coordinates
• polar
• cartesian

README

PHP library for calculations in the Cartesian or polar coordinate system.

Requirements

• PHP: >=5.4

Add to composer

composer require rkondratuk/geo-math-php:^1

Example:

<?php

use PhpGeoMath\Model\GeoSegment;
use PhpGeoMath\Model\Cartesian3dPoint;
use PhpGeoMath\Model\Polar3dPoint;

/*
 * Create polar point (in polar coordinates)
 */

// Rockefeller center coordinates
$latitude = 40.758742779050706;
$longitude = -73.97855507715238;

$polarPoint1 = new Polar3dPoint(
    $latitude, $longitude, Polar3dPoint::EARTH_RADIUS_IN_METERS
);

// Empire State Building coordinates
$polarPoint2 = new Polar3dPoint(
    40.74843388072615, -73.98566565776102, Polar3dPoint::EARTH_RADIUS_IN_METERS
);

// The Morgan Library & Museum coordinates
$polarPoint3 = new Polar3dPoint(
    40.74919365249446, -73.98133456388013, Polar3dPoint::EARTH_RADIUS_IN_METERS
);

/*
 * Create cartesian point (in cartesian coordinates)
 */
$x = 1001;
$y = 205;
$z = 512;

$cartesianPoint1 = new Cartesian3dPoint($x, $y, $z);

/*
 * Convert coordinates in alternative coordinates system
 */

$convertedCartesianPoint1 = $polarPoint1->buildCartesian3DPoint();
$convertedPolarPoint1 = $cartesianPoint1->buildPolar3dPoint();

/*
 * Calc GEO distance (by GEO arc) between two points
 */
$geoDistance = $polarPoint2->calcGeoDistanceToPoint($polarPoint1);

/*
 * Calc the nearest point (point-x) from GEO segment [point-1, point-2] to some GEO point (3)
 * Point (point-x) placed between [point-1, point-2]
 */
$arcSegmentFirst = new GeoSegment($polarPoint1, $polarPoint2);
$nearestPolarPointX = $arcSegmentFirst->calcNearestPoint($polarPoint3);

/*
 * Shortest distance from point-3 to segment [point-1, point-2] 
 * is distance between point-3 and point-x
 */
$nearestGeoDistance = $nearestPolarPointX->calcGeoDistanceToPoint($polarPoint3);

// Use Earth radius in miles for calculations in miles
Polar3dPoint::EARTH_RADIUS_IN_MILES;

Bitcoin address for donates: bc1qwa5wmta36e8a2wrvpa9jyplgzg4pjad7grwm29