Récupérer une liste de communes et leurs infrastructures

Présentation

Cette ressource permet de réaliser une recherche de communes sur un département et retourne :

  • Code INSEE de la commune
  • Nom de la commune
  • URL correspondant à la page commune du site eTerritoire.fr, qui donne de nombreuses informations sur les 36000 communes de France
  • Coordonnées GPS de la commune
  • Données sur le nombre d’équipements sportifs, de santé, d’éducation, de loisirs, et de services publics présents dans la commune
  • Nom des communes à proximité

 

Description de la requête

Point d'accès

GET https://api.emploi-store.fr/partenaire/eterritoire/v1/cadre-de-vie.php

 

Paramètres d'entrée

En-tête(s) Valeur
Authorization

Bearer [Access token]

Code Cardinalité Format Description Obligatoire
dep

1,1

Integer 2

numéro du département à appeler (84 = Département du Vaucluse)

non
proxycom 2,1 Integer 2, Integer 3

5 communes à proximité, sur une distance de 10km (30 communes est le maximum)

non

 

Exemple d'appel

GET https://api.emploi-store.fr/partenaire/eterritoire/v1/cadre-de-vie.php?dep=84&proxycom=5,10
Authorization: Bearer [Access token]

 

Description de la réponse

Données retournées

Code Cardinalité Format Description
idinsee 1,1 Integer 5 code INSEE de la commune
nom 1,1 String

nom de la commune

url 1,1 String URL de la page commune du site eterritoire.fr
pop 1,1 Integer population de la commune
equipements 1,1 Sous balise

nombre d’équipements dans la commune

equipements.Équipements sportifs 1,1 Integer

nombre d’équipements sportifs

equipements.Santé 1,1 Integer nombre d’équipements de santé
equipements.Éducation 1,1 Integer

nombre d’équipements d’éducation

equipements.Loisirs 1,1 Integer nombre d’équipements de loisirs
equipements.Services publics 1,1 Integer nombre d’équipements de services publics
gps 2,1 [Double, Double] coordonnées GPS de la commune
proxycom 1,1 Sous balise communes à proximité (selon paramètre défini)
ncom 1,1 String

nom de la n-ième commune à proximité

cp 1,1 Integer 5 code postal de la n-ième commune à proximité
distance 1,1 Double

distance en km de la n-ième commune à proximité

pop 1,1 Integer

population de la n-ième commune à proximité

 

Exemple de retour

HTTP 200 OK
Content-Type: application/json;charset=UTF-8

[
    {
        "idinsee": "84001",
        "nom": "Althen-des-Paluds",
        "url": "/territoires/provence-alpes-cote-d-azur/vaucluse/althen-des-paluds/84001/34080#a2",
        "pop": "2671",
        "equipements": {
            "Équipements sportifs": 6,
            "Santé": 19,
            "Éducation": 3,
            "Loisirs": 2,
            "Services publics": 1
        },
        "gps": [
            44.004444122314,
            4.9577779769897
        ],
        "proxycom": [
            {
                "ncom": "Entraigues-sur-la-Sorgue",
                "cp": 84320,
                "distance": 2.44,
                "pop": 8230
            },
            {
                "ncom": "Monteux",
                "cp": 84170,
                "distance": 4.72,
                "pop": 12537
            },
            {
                "ncom": "Vedène",
                "cp": 84270,
                "distance": 5.13,
                "pop": 11045
            },
            {
                "ncom": "Saint-Saturnin-lès-Avignon",
                "cp": 84450,
                "distance": 5.59,
                "pop": 4830
            },
            {
                "ncom": "Bédarrides",
                "cp": 84370,
                "distance": 6.19,
                "pop": 5010
            }
        ]
    }

]

 

Cas d'erreurs possibles

Retrouvez la liste des cas d'erreurs possibles sur la page Erreurs Types.