README

phpgeo 提供地理坐标（包括对不同椭球体的支持）的抽象，并允许您以高精度计算坐标之间的地理距离。

• 要求
• 文档
• 安装
• 特性
• 许可
• 示例/用法
  • 两个坐标之间的距离（Vincenty 公式）
  • 简化折线
  • 多边形包含一个点（例如，“GPS 地理围栏”）
  • 坐标的格式化输出
    • 十进制度
    • 度/分/秒（DMS）
    • GeoJSON
• 鸣谢

要求

最低要求的 PHP 版本是 7.0。

文档

文档可在 https://phpgeo.marcusjaschen.de/ 找到

API 文档也可用： https://phpgeo.marcusjaschen.de/api/master

安装

使用 Composer，只需在运行

composer require mjaschen/phpgeo

许可

从版本 2.0.0 开始，phpgeo 采用 MIT 许可证。旧版本采用 GPL 许可证。

特性

信息：请访问 文档站点 以获取完整和最新的文档！

phpgeo 提供以下功能（通过链接获取示例）

• 几个几何对象（坐标/点、线、折线/GPS 轨迹、多边形）的抽象
• 支持不同的 椭球体，例如 WGS-84
• 使用不同的实现（Haversine、Vincenty）进行 长度/距离/周长计算
• 地理围栏 计算，即回答“该点是否包含在该区域/多边形中？”的问题
• 格式化和输出几何对象（GeoJSON、漂亮的字符串等，例如 18° 54′ 41″ -155° 40′ 42″）
• 计算两点之间的 方位角（球面或使用 Vincenty 公式）
• 计算给定起始点、方位角和距离的 目标点（球面或使用 Vincenty 公式）
• 计算点与线之间的 垂直距离
• 获取折线/多边形的 段、
• 反转方向的折线/多边形

示例/用法

此列表不完整，请访问 文档站点 以获取完整文档和示例！

两个坐标之间的距离（Vincenty 公式）

直接使用计算器对象

<?php

use Location\Coordinate;
use Location\Distance\Vincenty;

$coordinate1 = new Coordinate(19.820664, -155.468066); // Mauna Kea Summit
$coordinate2 = new Coordinate(20.709722, -156.253333); // Haleakala Summit

$calculator = new Vincenty();

echo $calculator->getDistance($coordinate1, $coordinate2); // returns 128130.850 (meters; ≈128 kilometers)

或通过注入计算器对象来调用坐标对象的 getDistance() 方法

<?php

use Location\Coordinate;
use Location\Distance\Vincenty;

$coordinate1 = new Coordinate(19.820664, -155.468066); // Mauna Kea Summit
$coordinate2 = new Coordinate(20.709722, -156.253333); // Haleakala Summit

echo $coordinate1->getDistance($coordinate2, new Vincenty()); // returns 128130.850 (meters; ≈128 kilometers)

简化折线

折线可以简化以节省存储空间或带宽。简化使用 Ramer–Douglas–Peucker 算法（又称 Douglas-Peucker 算法）进行。

<?php

use Location\Coordinate;
use Location\Polyline;
use Location\Distance\Vincenty;

$polyline = new Polyline();
$polyline->addPoint(new Coordinate(10.0, 10.0));
$polyline->addPoint(new Coordinate(20.0, 20.0));
$polyline->addPoint(new Coordinate(30.0, 10.0));

$processor = new Simplify($polyline);

// remove all points which perpendicular distance is less
// than 1500 km from the surrounding points.
$simplified = $processor->simplify(1500000);

// simplified is the polyline without the second point (which
// perpendicular distance is ~1046 km and therefore below
// the simplification threshold)

多边形包含一个点（例如，“GPS 地理围栏”）

phpgeo 具有一个多边形实现，可以用来确定一个点是否包含在其中。多边形由至少三个点组成。点是 Coordinate 类的实例。

警告：如果多边形的点位于180/-180度子午线上，计算结果将不正确。

<?php

use Location\Coordinate;
use Location\Polygon;

$geofence = new Polygon();

$geofence->addPoint(new Coordinate(-12.085870,-77.016261));
$geofence->addPoint(new Coordinate(-12.086373,-77.033813));
$geofence->addPoint(new Coordinate(-12.102823,-77.030938));
$geofence->addPoint(new Coordinate(-12.098669,-77.006476));

$outsidePoint = new Coordinate(-12.075452, -76.985079);
$insidePoint = new Coordinate(-12.092542, -77.021540);

var_dump($geofence->contains($outsidePoint)); // returns bool(false) the point is outside the polygon
var_dump($geofence->contains($insidePoint)); // returns bool(true) the point is inside the polygon

坐标的格式化输出

您可以以不同的样式格式化坐标。

十进制度

<?php

use Location\Coordinate;
use Location\Formatter\Coordinate\DecimalDegrees;

$coordinate = new Coordinate(19.820664, -155.468066); // Mauna Kea Summit

echo $coordinate->format(new DecimalDegrees());

度/分/秒（DMS）

<?php

use Location\Coordinate;
use Location\Formatter\Coordinate\DMS;

$coordinate = new Coordinate(18.911306, -155.678268); // South Point, HI, USA

$formatter = new DMS();

echo $coordinate->format($formatter); // 18° 54′ 41″ -155° 40′ 42″

$formatter->setSeparator(", ")
    ->useCardinalLetters(true)
    ->setUnits(DMS::UNITS_ASCII);

echo $coordinate->format($formatter); // 18° 54' 41" N, 155° 40' 42" W

GeoJSON

<?php

use Location\Coordinate;
use Location\Formatter\Coordinate\GeoJSON;

$coordinate = new Coordinate(18.911306, -155.678268); // South Point, HI, USA

echo $coordinate->format(new GeoJSON()); // { "type" : "point" , "coordinates" : [ -155.678268, 18.911306 ] }

开发

运行测试

在提交拉取请求之前，请务必运行所有检查和测试，并确保一切正常。

要运行检查和测试，使用提供的 Composer 脚本是最简单的，例如：composer ci:lint

• 对 PHP 文件进行语法检查：composer ci:lint
• 使用 Psalm 运行静态分析并报告错误：composer ci:psalm
• 使用 PHPUnit 运行单元测试：composer ci:tests

要一次性运行所有检查和测试，只需使用 composer ci。

当然，也可以直接使用测试运行器，例如 PHPUnit。

./vendor/bin/phpunit

Psalm

./vendor/bin/psalm

杂项

@clemdesign 为 phpgeo 创建了一个 TypeScript 端口。

鸣谢

• Marcus Jaschen mail@marcusjaschen.de
• Chris Veness - 用于距离计算的 Vincenty 公式 的 JavaScript 实现
• Ersts,P.J., Horning, N., and M. Polin[互联网] 垂直距离计算器（版本 1.2.2）文档。美国自然历史博物馆，生物多样性保护中心。可通过 http://biodiversityinformatics.amnh.org/open_source/pdc 获取。访问日期：2013-07-07。
• W. Randolph Franklin，PNPOLY - 多边形中点测试 文档
• Richard Barnes Polyline GeoJSON 格式化器
• Paul Vidal 多边形实现