Retour : page principale > sommaire eFlore v5 > eFlore API v0.1

eFlore Api v0.1 : Zones Geo


Ce service fournit des informations sur les zones géographiques.
Les sources à utiliser pour ces données sont :
  • INSEE-P : Standard INSEE des Pays INSEE Pays
  • INSEE-R : Standard INSEE des Régions de France
  • INSEE-D : Standard INSEE des Départements de France
  • INSEE-C : Standard INSEE des Communes de France INSEE Communes
  • TDWG-ZG-N1 : Standard TDWG des zones géographiques niveau 1
  • TDWG-ZG-N2 : Standard TDWG des zones géographiques niveau 2
  • TDWG-ZG-N3 : Standard TDWG des zones géographiques niveau 3
  • TDWG-ZG-N4 : Standard TDWG des zones géographiques niveau 4
  • ISO-3166-1 : Standard ISO des noms de Pays sur 2 lettres
  • ISO-3166-2 : Standard ISO des subdivisions de Pays
  • ISO-3166-3 : Standard ISO de l'historique des pays
  • WPD-ZG : données sur les zones géographiques (population, capitale...) issues de Wikipedia

Descriptions des paramètres de requête du service
Ces paramètres sont optionnels et sont passés après le signe "?" dans l'URL.
  • masque : filtre la liste en fonction d'un masque de recherche portant sur le nom de la zone géographique. Ex. : "Franc%".
  • retour.langue : code ISO-639-1.alpha-2 disponible : fr, en.

Nom de champs à utiliser quelque soit les projets
En gras, les champs obligatoires :
  • id : identifiant numérique de la zone géographique. Si le projet n'en fournit pas, un identifiant alpha-numérique peut être utilisé à la place.
  • nom : le nom de la zone géographique si possible en français.
  • nom.origine : le nom de la zone géographique écrit dans la langue officielle de la zone en question si possible.
  • code : le code alpha-numérique le plus couramment utilisé (s'il en existe plusieurs) pour cette zone géographique.

/zones-geo
Retourne une liste de zones géographiques et leur identifiant. Par défaut, retourne seulement les 100 premières zones.
Défaut (=defaut) : JSON.
{
  • "entete" : {
    • "masque" : "nige%",
    • "depart" : "0",
    • "limite" : "100",
    • "total" : "2"
    • # pas de champ href.precédent ni href.suivant car nous avons que deux résultats qui sont affichés.
  • },
  • "resultats" : {
    • "562" : { # Id de la zone géographique
    • },
    • "566" : { # Id de la zone géographique
  • }
}


/zones-geo/#id
Retourne toutes les informations sur la zone géographique recherchée (champs différents selon projet toujours retourner un champ code et un champ nom).
Défaut (=max) : JSON.
Pour les urls :
http://tela-botanica.org/service:eflore:0.1/ISO-3166-1/2010/zones-geo/558
nous aurons :
{
  • "id" : "558",
  • "nom" : "Contient le nom par défaut pour ce projet (si possible en Français). Ici sera équivalant à nom.fr.",
  • "nom.fr" : "Nicaragua",
  • "nom.iso" : "NICARAGUA",
  • "nom.origine" : "Republica de Nicaragua",
  • "code" : "Contient le code par défaut pour ce projet. Ici sera équivalant à code.alpha-2.",
  • "code.alpha-2" : "NI",# Clé secondaire => code : alpha-2:NI
  • "code.alpha-3" : "NIC",# Clé secondaire => code : alpha-3:NIC
  • "code.numerique" : "558",...
  • # Peut contenir d'autres champs d'informations complémentaires spécifique au projet. Par exemple : surface, densité de population, capitale, préfecture...
}

/zones-geo/#id/#champ+#champ
Retourne l'information présent dans le champ indiqué pour la zone géographique recherchée
Défaut (=max) : JSON.
Pour les urls :
http://tela-botanica.org/service:eflore:0.1/ISO-3166-1/2010/zones-geo/558/nom.origine
nous aurons :
{
  • "id" : "558",
  • "nom.origine" : "Republica de Nicaragua"
}