Read the projection of an Italian comune with uncertainty and reliability
leggi_previsioni_comuneReads the statistical projection of one Italian municipality (comune) for the year after the latest ISTAT year: total, hotel and non-hotel nights and arrivals. Use it when you have the 6-digit cod_istat from cerca_comune and the question is what to expect next; do not use it for past figures (use leggi_serie_comune instead) or to set comuni side by side (use confronta_comuni instead). Each line gives last year's real figure, the projected figure and affidabilita_pct (0 to 100, measured by projecting a past year), and only the total has the p10 to p90 uncertainty band; a line that fails the checks has disponibile false and a motivo, a comune without a yearly series returns an empty list in linee with a nota, and a missing figure is null. These are estimates, not official statistics, and they are served only while the site shows projections to everyone, otherwise the call returns an error. Read-only, public, no authentication; 30 requests per minute per client, shared across tools.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cod_istat": "<cod_istat>"
},
"name": "leggi_previsioni_comune"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cod_istat | Yes | 6-digit ISTAT code of the comune as a string, leading zeros kept ("058091" is Roma); it comes from cerca_comune. An unknown code returns an error that says what to pass. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nome | Yes | Official name of the comune. | |
| nota | Yes | Notes in English on reading the projection: what it is, how the total and its band are built when the year adds any months ISTAT has already published, which lines are not projected and why, which may be derived from the total, where reliability is missing, and the change of ISTAT scope in 2025. When no projection is stored, it says so. | |
| fonte | Yes | Source to cite with the figures: processed by DatiTuristici.it from institutional data (ISTAT). | |
| linee | Yes | The four lines in the order totale, alberghieri, extra, arrivi; an empty list when no projection is stored for this comune (see `nota`). | |
| metodo | Yes | Name of the statistical model that made the projections; null when none is stored. | |
| scheda | Yes | Link to the comune's public page on datituristici.it, to cite. | |
| cod_istat | Yes | 6-digit ISTAT code of the comune, as a string with leading zeros kept. | |
| anno_orizzonte | Yes | The one year projected: the year after the latest year with ISTAT yearly figures. Null when no projection is stored for this comune (see `nota`). | |
| soglia_affidabilita_bassa | Yes | Reliability percentage below which the site labels a projection as low; null when no projection is stored. |