php-extended/php-api-fr-gouv-api-geo-object

A library that implements the php-extended/php-api-fr-gouv-api-geo-interface library


README

A library that implements the php-extended/php-api-fr-gouv-api-geo-interface library.

coverage build status

Installation

The installation of this library is made via composer. Download composer.phar from their website. Then add to your composer.json :

	"require": {
		...
		"php-extended/php-api-fr-gouv-api-geo-object": "^3",
		...
	}

Then run php composer.phar update to install this library. The autoloading of all classes of this library is made through composer's autoloader.

Basic Usage

This library may be used the following way :


use PhpExtended\GeoApiGouvFr\GeoApiGouvFrEndpoint;

/** @var $client \Psr\Http\Client\ClientInterface */

$endpoint = new GeoApiGouvFrEndpoint($client);

foreach($endpoint->getRegions() as $region)
{
	// do something with regions
}

foreach($endpoint->getDepartements() as $departement)
{
	// do something with departements
}

foreach($endpoint->getCommunes() as $commune)
{
	// do something with communes
}

Note that the $endpoint->getCommunes() method does not recover the polygons about the communes. To have them, you have to get communes from each departement like so :


foreach($endpoint->getDepartements() as $departement)
{
	foreach($endpoint->getCommunesFromDepartement($departement->getCode()) as $commune)
	{
		$commune->getGeometry(); // polygon or multi polygon
	}
}

License

MIT (See license file).