ronanguilloux/geocodertoolkit

Geo-related utils & toolkit PHP library, build atop the Geocoder lib

GeocoderToolkit

GeocoderToolkit is a geo-related utils & toolkit PHP library, build atop the Geocoder library, _(*1)

It provides simple tools such as * distant geopoints coordinates calculation (bounding box angles, etc.) * other geo-related tools to come (all contributors will be fully credited!), _(*2)

, _(*3)

Installation

GeocoderToolkit is not a stand-alone library: it assumes strong dependency with the Geocoder PHP library., _(*4)

The recommended way to install Geocoder is through composer., _(*5)

Just create a composer.json file for your project:, _(*6)

``` json { "require": { "php": ">=5.3.0", "willdurand/geocoder": "master-dev", "ronanguilloux/geocodertoolkit": "master-dev" } }, <sub>(*7)</sub>

And run these two commands to install it:

``` bash
$ wget http://getcomposer.org/composer.phar
$ php composer.phar install

Now you can add the autoloader, and you will have access to the library:, <sub>(*8)</sub>

``` php <?php, <sub>(*9)</sub>

require 'vendor/autoload.php';, <sub>(*10)</sub>

If you don't use neither **Composer** nor a _ClassLoader_ in your application, just require the provided autoloader:

``` php
<?php

require_once 'src/autoload.php';

Usage

Here is an example of how to determine a new geopoint, 500 kilometers away from an origin, in the north-east direction:, <sub>(*11)</sub>

``` php <?php, <sub>(*12)</sub>

$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, <sub>(*13)</sub>

API
---

You can provide your own `geometry` tool, you just need to create a new class which implements `GeometryInterface`.


Unit Tests
----------

To run unit tests, you'll need `cURL` and a set of dependencies you can install using Composer:

``` bash
$ php composer.phar install --dev

Once installed, just launch the following command:, <sub>(*14)</sub>

bash $ phpunit, <sub>(*15)</sub>

Credits

• Ronan Guilloux ronan.guilloux@gmail.com
• All contributors

License

GeocoderToolkit is released under the MIT License. See the bundled LICENSE file for details. You can find a copy of this software here: https://github.com/ronanguilloux/GeocoderToolkit, <sub>(*16)</sub>