README

cvilleger/geo-gouv

About

Query geographic reference data easily using offline data from 🇫🇷 Gouv administrative division API.

Features

• Query all departments data
• Query all municipalities by department code

Requirements

• PHP 8.3 or above

Installation

Install this package as a dependency using Composer.

  composer require cvilleger/geo-gouv

Note that this package has zero composer dependencies.

Usage

Retrieve departments

use Cvilleger\GeoGouv\Client;

$client = new Client();

$departements = $client->getDepartements();

print_r($departements[0]);
/*
Cvilleger\GeoGouv\Model\Departement Object
(
    [nom] => Ain
    [code] => 01
    [codeRegion] => 84
    [coordinates] => 46.06551335, 5.28478031423462
    [region] => Cvilleger\GeoGouv\Model\Region Object
        (
            [nom] => Auvergne-Rhône-Alpes
            [code] => 84
        )

)
*/

Retrieve municipalities by department code

use Cvilleger\GeoGouv\Client;

$client = new Client();

$communes = $client->getCommunesByDepartementCode('01');

print_r($communes[0]);
/*
(
    [nom] => L'Abergement-Clémenciat
    [code] => 01001
    [codesPostaux] => Array
        (
            [0] => 01400
        )

    [centre] => Cvilleger\GeoGouv\Model\Centre Object
        (
            [type] => Point
            [coordinates] => Array
                (
                    [0] => 4.9306
                    [1] => 46.1517
                )

        )

    [surface] => 1564.5
    [population] => 832
    [departement] => Cvilleger\GeoGouv\Model\CommuneDepartement Object
        (
            [nom] => Ain
            [code] => 01
        )

    [region] => Cvilleger\GeoGouv\Model\CommuneRegion Object
        (
            [nom] => Auvergne-Rhône-Alpes
            [code] => 84
        )

)
*/