GeokitPHP 地理工具包-技术圈

Geokit 是一个 PHP 工具包，用于解决与地理相关的任务，例如：

距离计算。
航向、中点和终点计算。
矩形边界框计算。

安装

使用 Composer 安装最新版本

composer require geokit/geokit

检查 Packagist 页面以获取所有可用版本。

参考

距离

距离实例允许方便地表示距离测量单位。

use Geokit\Distance;

$distance = new Distance(1000); // Defaults to meters
// or
$distance = new Distance(1, Distance::UNIT_KILOMETERS);

$meters = $distance->meters();
$kilometers = $distance->kilometers();
$miles = $distance->miles();
$yards = $distance->yards();
$feet = $distance->feet();
$inches = $distance->inches();
$nauticalMiles = $distance->nautical();

距离也可以从带有可选单位的字符串中创建。

use Geokit\Distance;

$distance = Distance::fromString('1000'); // Defaults to meters
$distance = Distance::fromString('1000m');
$distance = Distance::fromString('1km');
$distance = Distance::fromString('100 miles');
$distance = Distance::fromString('100 yards');
$distance = Distance::fromString('1 foot');
$distance = Distance::fromString('1 inch');
$distance = Distance::fromString('234nm');

位置

APosition是在x（或longitude）和y（或latitude）坐标中表示地理位置的基本结构。

经度范围在 -180 度和 180 度之间，包括端值。高于 180 或低于 -180 的经度被归一化。例如，480、840 和 1200 都将归一化为 120 度。
纬度范围在 -90 度和 90 度之间（含）。高于 90 或低于 -90 的纬度被归一化。例如，100 将归一化为 80 度。

use Geokit\Position;

$position = Position::fromXY(181, 91);

$x = $position->x(); // Returns -179.0, normalized
$y = $position->y(); // Returns 89.0, normalized

边界框

BoundingBox 实例表示地理坐标中的一个矩形，包括一个跨越 180 度纵向子午线的矩形。

它由左下（西南）和右上（东北）角点构成。

use Geokit\BoundingBox;
use Geokit\Position;

$southWest = Position::fromXY(2, 1);
$northEast = Position::fromXY(2, 1);

$boundingBox = BoundingBox::fromCornerPositions($southWest, $northEast);

$southWestPosition = $boundingBox->southWest();
$northEastPosition = $boundingBox->northEast();

$center = $boundingBox->center();

$span = $boundingBox->span();

$boolean = $boundingBox->contains($position);

$newBoundingBox = $boundingBox->extend($position);
$newBoundingBox = $boundingBox->union($otherBoundingBox);

使用expand()和shrink()方法，可以按一定距离扩展或缩小 BoundingBox 实例。

use Geokit\Distance;

$expandedBoundingBox = $boundingBox->expand(
    Distance::fromString('10km')
);

$shrinkedBoundingBox = $boundingBox->shrink(
    Distance::fromString('10km')
);