gilmarodp/haversine

A PHP library to calculate distance between coordinates using the Haversine formula.

1.0.0 2025-06-08 23:36 UTC

This package is auto-updated.

Last update: 2025-07-15 13:29:24 UTC


README

A PHP library to calculate the distance between coordinates using the Haversine formula.

Buy Me A Coffee

🚀 Installation

Use Composer:

Install via Composer:

composer require gilmarodp/haversine

📦 Usage

Image
<?php

require 'vendor/autoload.php'; // optional

use Gilmarodp\Haversine\Point;
use Gilmarodp\Haversine\Calculator;

// Define point A (latitude, longitude)
$pointA = new Point(-23.55052, -46.633308);

// Define point B (latitude, longitude)
$pointB = new Point(-23.55100, -46.634000);

// Calculate the distance between point A and point B in meters
$distance = Calculator::distance($pointA, $pointB);

// Show the distance
echo "Distance: {$distance} meters";
// Expected output: Distance: 88.455106784955 meters

📘 API

Point: Represents a geographic point.

new Point(float $latitude, float $longitude)

Calculator: Calculator abstration

Calculator::distance(Point $from, Point $to): float

This static function returns the distance in meters between two points.

✅ Requirements

🐘 PHP 7.4 or higher

👤 Author

Gilmar Oliveira

Version

MIT - LICENSE