phelium/geoapifr

GeoApi France

GeoApiFr

Wrapper PHP de l'API Geo fournie par le gouvernement français., _(*1)

Installation

Avec Composer, ajoutez cette ligne dans votre fichier composer.json :, _(*2)

"phelium/geoapifr": "dev-master"

Lancez ensuite composer update., _(*3)

Ou, exécutez simplement cette commande dans votre terminal :, _(*4)

composer require phelium/geoapifr

Utilisation

require 'vendor/autoload.php';

use Phelium\Component\GeoApiFr;

Communes

Pour avoir les détails d'une commune, utilisez la méthode communes()., _(*5)

Les champs disponibles en retour sont :, _(*6)

Les champs autorisés pour la recherche sont :, _(*7)

Exemple de recherche de la commune dont le nom est "Versailles" :, _(*8)

$GeoApiFr = new \Phelium\Component\GeoApiFr;
$datas = $GeoApiFr
    ->communes()
    ->fields(array('code', 'codeDepartement', 'codeRegion', 'nom'))
    ->search('nom', 'Versailles');

Retour :, _(*9)

Array
(
    [status_code] => 200
    [status_msg] => OK
    [url] => https://geo.api.gouv.fr/communes?nom=Versailles&fields=code,codeDepartement,codeRegion,nom
    [datas] => Array
        (
            [0] => Array
                (
                    [code] => 78646
                    [codeDepartement] => 78
                    [codeRegion] => 11
                    [nom] => Versailles
                    [_score] => 1
                )

        )
)

Départements

Pour avoir les détails d'un département, utilisez la méthode departements()., _(*10)

Les champs disponibles en retour sont :, _(*11)

Les champs autorisés pour la recherche sont :, _(*12)

Exemple de recherche du département dont le code est "2A" :, _(*13)

$GeoApiFr = new \Phelium\Component\GeoApiFr;
$datas = $GeoApiFr
    ->departements()
    ->fields(array('code', 'codeRegion', 'nom'))
    ->search('code', '2A');

Retour :, _(*14)

Array
(
    [status_code] => 200
    [status_msg] => OK
    [url] => https://geo.api.gouv.fr/departements?code=2A&fields=code,codeRegion,nom
    [datas] => Array
        (
            [0] => Array
                (
                    [code] => 2A
                    [codeRegion] => 94
                    [nom] => Corse-du-Sud
                )

        )
)

Régions

Pour avoir les détails d'une région, utilisez la méthode regions()., _(*15)

Les champs disponibles en retour sont :, _(*16)

Les champs autorisés pour la recherche sont :, _(*17)

Exemple de recherche de la région dont le code est "94" :, _(*18)

$GeoApiFr = new \Phelium\Component\GeoApiFr;
$datas = $GeoApiFr
    ->regions()
    ->fields(array('code', 'nom'))
    ->search('code', '94');

Retour :, _(*19)

Array
(
    [status_code] => 200
    [status_msg] => OK
    [url] => https://geo.api.gouv.fr/regions?code=94&fields=code,nom
    [datas] => Array
        (
            [0] => Array
                (
                    [code] => 94
                    [nom] => Corse
                )

        )
)