ronanguilloux/geocodertoolkit

地理相关的实用工具和PHP库,基于Geocoder库构建

dev-master 2012-11-03 01:46 UTC

This package is auto-updated.

Last update: 2024-09-22 20:16:27 UTC


README

GeocoderToolkit 是一个与地理相关的实用工具和PHP库,基于Geocoder库构建

它提供了一些简单的工具,例如

  • 地理点坐标距离计算(边界框角度等)
  • 其他即将推出的地理相关工具(所有贡献者都将得到充分认可!)

Build Status

安装

GeocoderToolkit 不是一个独立的库:它假设与Geocoder PHP库有强烈的依赖关系。

安装Geocoder的推荐方法是使用composer

只需为您的项目创建一个composer.json文件

{
     "require": {
        "php": ">=5.3.0",
        "willdurand/geocoder": "master-dev",
        "ronanguilloux/geocodertoolkit": "master-dev"
    }
}

然后运行以下两个命令来安装它

$ wget https://getcomposer.org.cn/composer.phar
$ php composer.phar install

现在您可以添加自动加载器,并将能够访问库

<?php

require 'vendor/autoload.php';

如果您在应用程序中既不使用Composer也不使用ClassLoader,则只需引入提供的自动加载器

<?php

require_once 'src/autoload.php';

用法

以下是一个示例,说明如何确定一个新地理点,在起始点北东方向500公里处

<?php

$origin = new Geocoded();
$origin->fromArray(array('latitude'=>'47.218371', 'longitude'=>'-1.553621')); // Nantes, Loire valley, France
$geometry = new BoundingBoxGeometry();
// 45 = bearing angle, 500 = distance, 'kilometer' is default, but miles are OK
$northEast = $geometry->getAngle($origin, 45, 500); // a new geocoded resource

API

您可以提供自己的geometry工具,您只需要创建一个实现GeometryInterface的新类。

单元测试

要运行单元测试,您需要cURL和一组依赖项,您可以使用Composer安装这些依赖项

$ php composer.phar install --dev

安装完成后,只需启动以下命令

$ phpunit

鸣谢

许可协议

GeocoderToolkit 在MIT许可下发布。有关详细信息,请参阅附带的LICENSE文件。您可以在以下位置找到此软件的副本:https://github.com/ronanguilloux/GeocoderToolkit