Gemeindesuche - Italien

Der ISTAT-Code ist eine numerische Kennung, die das italienische Nationale Institut für Statistik jeder bestehenden oder neuen Gemeinde zuweist und die für statistische Zwecke verwendet wird.

Es handelt sich um einen alphanumerischen Code, der aus sechs Ziffern besteht: Die ersten drei Ziffern des Codes bezeichnen die Provinz, zu der die Gemeinde gehört, während die nächsten drei Ziffern die Gemeinde innerhalb ihrer Provinz bezeichnen.

Der Dienst „Suche in Gemeinden“ gehört zur API Postleitzahl und ermöglicht es Ihnen, die ISTAT-Städtecodes und die dazugehörigen Gemeinden zu überprüfen, zu erhalten und zu aktualisieren. Die Suche nach Gemeinden wird durch den Endpoint GET https://cap.openapi.it/cerca_comuni

Der Dienst bietet 44.640 kostenlose Abfragen pro Monat und ermöglicht die Ermittlung des ISTAT-Codes anhand einer Reihe von Parametern wie z. B:

Ein oder mehrere Parameter können in derselben Anfrage kombiniert werden.

Das Feld „Name (Stadt)“ ermöglicht eine textuelle Suche und zeigt alle Städte, die diesen Namen enthalten, in den Ergebnissen an. Wenn der Suchparameter für den Städtenamen beispielsweise „Roma“ lautet, werden in der Antwort andere Städte angezeigt, die „roma“ enthalten, wie Campagnano di Roma oder Trevignano Romano. Es ist möglich, die Suche mit anderen Parametern wie Provinz, Region und Postleitzahl zu verfeinern.

BEISPIELANFORDERUNG

GET /cerca_comuni

Dies ist ein Beispiel für eine Abfrage, bei der wir die Gemeinde Florenz als Parameter gewählt haben

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

Die Antwort kann je nach den verwendeten Parametern eine oder mehrere Städte mit den folgenden Informationen enthalten:

BEISPIELANTWORT

GET /cerca_comuni

Ein Beispiel für eine Antwort:

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

Im Falle einer Unterdrückung bleibt der sechsstellige alphanumerische Code, der sie zum Zeitpunkt der Unterdrückung identifizierte, der unterdrückten Gemeinde zugeordnet und wird nicht mehr neu zugewiesen. Im Falle einer Namensänderung bleibt der Code unverändert und wird dem neuen Namen zugeordnet.

Der ermittelte ISTAT-Code kann dann verwendet werden, um über andere Endpunkte, wie z.B. Basic oder Advanced Municipalities, weitere Informationen über Gemeinden zu erhalten.