PHPackages                             phelium/geoapifr - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. phelium/geoapifr

ActiveLibrary[API Development](/categories/api)

phelium/geoapifr
================

GeoApi France

1.0(8y ago)2796↑900%1GNU GPL 3.0PHPPHP >=5.3.0

Since Jan 19Pushed 8y agoCompare

[ Source](https://github.com/phelium-php/phelium-geoapifr)[ Packagist](https://packagist.org/packages/phelium/geoapifr)[ Docs](https://github.com/phelium-php/phelium-geoapifr)[ RSS](/packages/phelium-geoapifr/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (3)DependenciesVersions (4)Used By (0)

GeoApiFr
========

[](#geoapifr)

Wrapper PHP de l'[API Geo](https://api.gouv.fr/api/api-geo.html) fournie par le gouvernement français.

Installation
------------

[](#installation)

Avec Composer, ajoutez cette ligne dans votre fichier `composer.json` :

```
"phelium/geoapifr": "dev-master"

```

Lancez ensuite `composer update`.

Ou, exécutez simplement cette commande dans votre terminal :

```
composer require phelium/geoapifr

```

Utilisation
-----------

[](#utilisation)

```
require 'vendor/autoload.php';

use Phelium\Component\GeoApiFr;
```

### Communes

[](#communes)

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

Les champs disponibles en retour sont :

Nom du champTypeDescriptifcodestringCode INSEE de la communecodeDepartementstringCode du département associé à la communecodeRegionstringCode de la région associée à la communenomstringNom de la communecodesPostauxarrayListe des codes postaux associés à la communesurfacenumberSurface de la commune, en mètres-carréspopulationintegerPopulation municipalecentrearrayCentre de la commune (point GeoJSON)contourarrayContour de la commune (polygon GeoJSON)departementarrayDépartementregionarrayRégionLes champs autorisés pour la recherche sont :

Nom du champcodePostalcodeDepartementcodeRegionnomlonlatExemple de recherche de la commune dont le nom est "Versailles" :

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

Retour :

```
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

[](#départements)

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

Les champs disponibles en retour sont :

Nom du champTypeDescriptifcodestringCode du départementnomstringNom du départementcodeRegionstringCode de la région associée au départementregionarrayRégionLes champs autorisés pour la recherche sont :

Nom du champcodecodeRegionnomExemple de recherche du département dont le code est "2A" :

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

Retour :

```
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

[](#régions)

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

Les champs disponibles en retour sont :

Nom du champTypeDescriptifcodestringCode de la régionnomstringNom de la régionLes champs autorisés pour la recherche sont :

Nom du champcodenomExemple de recherche de la région dont le code est "94" :

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

Retour :

```
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
                )

        )
)

```

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~104 days

Total

3

Last Release

3191d ago

Major Versions

0.2 → 1.02017-08-16

### Community

Maintainers

![](https://www.gravatar.com/avatar/4e0e17e3945c589234ce1ae3edb38bdb9fa8ac609f97ad0462b25dc71d3a7b2d?d=identicon)[shevabam](/maintainers/shevabam)

---

Top Contributors

[![shevabam](https://avatars.githubusercontent.com/u/1798289?v=4)](https://github.com/shevabam "shevabam (6 commits)")

---

Tags

apigeofrance

### Embed Badge

![Health badge](/badges/phelium-geoapifr/health.svg)

```
[![Health](https://phpackages.com/badges/phelium-geoapifr/health.svg)](https://phpackages.com/packages/phelium-geoapifr)
```

###  Alternatives

[yandex/geo

PHP-library for interactions with geo-coding Yandex.Maps

117309.0k3](/packages/yandex-geo)[m165437/laravel-blueprint-docs

API Blueprint Renderer for Laravel

22779.0k](/packages/m165437-laravel-blueprint-docs)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)