Recherche de municipalités - Italie

Le code ISTAT est un identifiant numérique attribué par l'Institut national italien des statistiques à chaque municipalité existante ou nouvelle et est utilisé à des fins statistiques.

Il s'agit d'un code alphanumérique composé de six chiffres: les trois premiers chiffres du code identifient la province à laquelle la municipalité appartient, tandis que les trois suivants identifient la municipalité au sein de sa province.

Le service de recherche de municipalité fait partie de l'API Codes Postaux italiens et vous permet de vérifier, d'obtenir et de mettre à jour les codes de ville ISTAT et les municipalités qui leur sont associées. La recherche de municipalités est identifiée par l'endpoint GET https://cap.openapi.it/cerca_comuni

Le service fournit 44 640 requêtes gratuites par mois et permet d'obtenir le code ISTAT à partir d'un certain nombre de paramètres tels que:

Un ou plusieurs paramètres peuvent être combinés dans une même requête.

Le champ nom (ville) permet une recherche textuelle et présentera toutes les villes contenant ce nom dans les résultats. Par exemple, si le paramètre de recherche pour le nom de la ville est «Rome», la réponse renverra d'autres villes contenant «roma», telles que Campagnano di Roma ou Trevignano Romano. Il est possible d'affiner la recherche en utilisant d'autres paramètres tels que la province, la région et le code postal.

EXEMPLE DE REQUÊTE

GET /cerca_comuni

Voici un exemple de requête dans laquelle nous avons choisi la commune de Florence comme paramètre.

https://cap.openapi.it/cerca_comuni?comune=Firenze

La réponse peut comprendre une ou plusieurs villes, en fonction des paramètres utilisés, avec les informations suivantes:

EXEMPLE DE RÉPONSE

GET /cerca_comuni

Ceci est un exemple de réponse:

{
  "data": {
      "istat": "48017",
      "comune": "Firenze",
      "suppressed":false
     }
  ],
   "suppressed": []
  },
  "success": true,
  "message": "",
  "error": null
}

En cas de suppression, le code alphanumérique à six caractères qui l'identifiait au moment de la suppression reste attribué à la commune supprimée et n'est plus réattribué. En cas de changement de nom, le code reste inchangé et est attribué au nouveau nom.

Le code ISTAT obtenu peut ensuite être utilisé pour obtenir d'autres informations sur les municipalités via d'autres endpoints, tels que les municipalités de base ou les municipalités avancées.