黑色/地理

PHP 5.4+ 库,使处理地理坐标更加安全、便捷和有趣

v1.0.1 2014-11-08 13:10 UTC

This package is auto-updated.

Last update: 2024-08-29 03:47:19 UTC


README

PHP 5.4+ 库,使处理地理坐标更加安全、便捷和有趣!

SensioLabsInsight Build Status Scrutinizer Code Quality Latest Stable Version Total Downloads

安装

推荐通过 Composer 安装 Geo

{
    "require": {
        "black/geo": "@stable"
    }
}

提示:您应该浏览 [black/geo](https://packagist.org.cn/packages/black/geo 页面) 来选择一个稳定的版本使用,避免使用 @stable 元约束。

用法

此类的用法很简单。首先,地理坐标基于三个值:纬度、经度和海拔。海拔不是必需的,如果没有提供参数,则默认为0。

创建 Geo 对象的三个方法

$geo = new Geo\Coordinates(37.42242, -122.08585, 0);
$geo->getCoordinates(); // will return "37.42242,-122.08585,0"
Geo\Coordinates::fromCoordinatesAsString("37.42242,-122.08585,0")
    ->getLatitude(); // will return "37.42242"
Geo\Coordinates::fromCoordinatesAsArray([37.42242, -122.08585, 0])
    ->getCoordinates(); // will return "37.42242,-122.08585,0"

获取器

可用获取器的列表

  • getLatitude()
  • getLongitude()
  • getElevation()
  • getCoordinates()
  • getCoordinatesAsArray()

检查两个地理坐标是否相等

  • isEqualTo(Geo $geo)

异常

如果您想传递1个或更少的参数,或者4个或更多的参数,将抛出 Geo\Exception\InvalidCoordinatesException() 异常。

许可

Geo 在 MIT 许可下发布。有关详细信息,请参阅附带许可证文件。

贡献

查看 CONTRIBUTING 文件。

鸣谢

此 README 严重受到 Geocoder 库的启发,该库由伟大的 @willdurand 创建。这位先生需要您的 PR 来实现 PHP 中的 REST。

Alexandre "pocky" Balmes alexandre@lablackroom.com。如果您喜欢我的工作,请给我 Flattrs送我礼物 或雇佣我!