GeocoderToolkit is a geo-related utils & toolkit PHP library, build atop the Geocoder library
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!)
GeocoderToolkit is not a stand-alone library: it assumes strong dependency with the Geocoder PHP library.
The recommended way to install Geocoder is through composer.
Just create a composer.json
file for your project:
{
"require": {
"php": ">=5.3.0",
"willdurand/geocoder": "master-dev",
"ronanguilloux/geocodertoolkit": "master-dev"
}
}
And run these two commands to install it:
$ wget http://getcomposer.org/composer.phar
$ php composer.phar install
Now you can add the autoloader, and you will have access to the library:
<?php
require 'vendor/autoload.php';
If you don't use neither Composer nor a ClassLoader in your application, just require the provided autoloader:
<?php
require_once 'src/autoload.php';
Here is an example of how to determine a new geopoint, 500 kilometers away from an origin, in the north-east direction:
<?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
You can provide your own geometry
tool, you just need to create a new class which implements GeometryInterface
.
To run unit tests, you'll need cURL
and a set of dependencies you can install using Composer:
$ php composer.phar install --dev
Once installed, just launch the following command:
$ phpunit
- Ronan Guilloux ronan.guilloux@gmail.com
- All contributors
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