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')

);