{
  "schemaVersion": 1,
  "country": "IT",
  "canonicalIdentityRules": [
    {
      "entityType": "municipality",
      "idPattern": "it:istat:comune:<six-digit-current-ISTAT-code>",
      "identifierNamespace": "istat:comune",
      "authority": "ISTAT SITUAS",
      "sourceUrl": "https://www.istat.it/classificazione/codici-dei-comuni-delle-province-e-delle-regioni/",
      "notes": "Use the valid code for the selected reference date. Keep former/suppressed codes as historical identifiers, not current routes. Names alone never identify a municipality."
    },
    {
      "entityType": "statistical_locality",
      "idPattern": "it:istat:localita:2021:<LOC21_ID>",
      "identifierNamespace": "istat:localita:2021",
      "authority": "ISTAT Basi territoriali 2021",
      "sourceUrl": "https://www.istat.it/wp-content/uploads/2024/07/Descrizione-dei-dati-Basi-territoriali.pdf",
      "notes": "LOC21_ID is nationally unique for the 2021 locality dataset and is formed from PRO_COM plus COD_LOC. Its vintage must remain in the key. ISTAT locality types are centro abitato, nucleo abitato, localita produttiva and case sparse; this is not a complete legal register of every borgo/frazione name."
    },
    {
      "entityType": "settlement_or_named_place_without_an_ISTAT_locality_id",
      "idPattern": "wikidata:Q<verified-item-id> or osm:<node|way|relation>:<verified-element-id>",
      "identifierNamespace": "wikidata or osm element type",
      "authority": "Wikidata or OpenStreetMap",
      "sourceUrl": "https://www.wikidata.org/ or https://www.openstreetmap.org/",
      "notes": "Use only a source-backed identifier. Store parentTerritoryId pointing to a verified municipality/locality. Do not use the place name as a unique key; maintain source and observation date because OSM elements can change."
    }
  ],
  "supportedEntityTypes": [
    "region",
    "province",
    "municipality",
    "statistical_locality",
    "settlement",
    "hamlet",
    "borough"
  ],
  "supportedCategoryIds": [
    "musei",
    "monumenti",
    "punti_interesse",
    "luoghi_culto"
  ],
  "placeOfWorshipSubtypes": [
    "chiesa",
    "cattedrale",
    "basilica",
    "santuario",
    "monastero",
    "sinagoga",
    "moschea",
    "tempio",
    "altro"
  ],
  "classificationRule": "A place may have multiple categories. Subtypes describe evidence and do not themselves create a route or record.",
  "homonymRule": "Resolve a request by namespaced canonical identifier and parent context; never route by locality name alone.",
  "currentRegisteredTerritories": [
    "it:istat:comune:058091",
    "it:istat:comune:027042"
  ],
  "notRegisteredYet": [
    "other municipalities",
    "frazioni and borghi without verified identifiers",
    "monuments",
    "points of interest",
    "places of worship"
  ]
}