Heating system management - Cubic volume of buildings with central heating by heating units and location
Part of Poland's Local Data Bank (BDL), published by Statistics Poland (GUS), this API provides access to subject P3545 under Housing Economy and Municipal Infrastructure (archival data): the cubic volume of buildings served by central heating, broken down by heating units and location. Data are organized as yearly territorial series covering the full administrative hierarchy of Poland, from voivodship down to gmina level, with units identified via TERYT territorial codes. The dataset supports analysis of heating infrastructure and housing stock across Polish regions over time.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › ARCHIVAL DATA. Local Data Bank (BDL) subject P3545: yearly territorial series for Poland (voivodship to gmina level), units keyed by TERYT ids.
Trust score
How is this computed?Weighted across five axes. Tap a ring for what it measures.
Data schema (8 fields)
Click a field to see example values.
| Field | Type | Description |
|---|---|---|
| variable_idVariable id | string | GUS variable code identifying the measured series under subject P3545.GUS variable id selecting the measured series of subject P3545 (the n1/n2 dimension combination): 461728=total / total [dam3]; 461730=total / total [dam3]; 461732=total / total [dam3]; 461734=total / total [dam3]; 461736=total / total [dam3]; 461727=total / housing cooperatives [dam3]; 461729=total / housing cooperatives [dam3]; 461731=total / housing cooperatives [dam3]; 461733=total / housing cooperatives [dam3]; 461735=total / housing cooperatives [dam3]; 458751=in urban areas / total [dam3]; 458755=in urban areas / total [dam3]; 458759=in urban areas / total [dam3]; 458763=in urban areas / total [dam3]; 458767=in urban areas / total [dam3]; … (30 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P3545 for the full list). |
| unit_levelUnit level | integer | Territorial aggregation level, from country (0) down to gmina (6).Territorial aggregation level: 0=Poland, 1=macroregion, 2=voivodship (województwo), 3=region, 4=subregion, 5=powiat, 6=gmina. |
| year | integer | Reference year of the yearly data value.Reference year of the value (yearly series, back to 1995 for the oldest subjects). Filters server-side via the API's year parameter. |
| unit_idUnit id | string | 12-digit BDL territorial unit identifier.12-digit BDL territorial-unit id (macroregion+voivodship+region+subregion+powiat+gmina+type digits). An equality filter pins the unit server-side (unit-parent-id). |
| unit_nameUnit name | string | Name of the territorial unit, e.g. country, voivodship or gmina.Name of the territorial unit, e.g. country, voivodship or gmina. |
| teryt_tercTeryt terc | string | TERYT TERC administrative code derived from the unit id.TERYT TERC territorial code derived from the unit id (2 digits = voivodship, 4 = powiat, 7 = gmina incl. type digit; empty for NUTS-only units). |
| value | number | Cubic volume of buildings with central heating, in dam³.Cubic volume of buildings with central heating, in dam³. |
| attr_idAttr id | integer | GUS attribute code flagging data quality or notes for the value.GUS value-attribute id (data quality/annotation flag). |
Schema captured from bdl 5 days ago.
Query the data
Pick columns and a sort, then fetch a live preview straight from the source. Choose an API-filterable column (marked ▾) under “Where” to pick from its list of values.
Sample data (8 records)
| variable_id | unit_level | year | unit_id | unit_name | teryt_terc | value | attr_id |
|---|---|---|---|---|---|---|---|
| 461728 | — | 2003 | 000000000000 | POLAND | — | 1758756.4 | 3 |
| 461728 | — | 2004 | 000000000000 | POLAND | — | 1703337.3 | 3 |
| 461728 | — | 2005 | 000000000000 | POLAND | — | 1745426.9 | 3 |
| 461728 | — | 2006 | 000000000000 | POLAND | — | 1785176 | 3 |
| 461728 | — | 2007 | 000000000000 | POLAND | — | 1772689.8 | 3 |
| 461728 | — | 2008 | 000000000000 | POLAND | — | 1812974 | 3 |
| 461728 | — | 2009 | 000000000000 | POLAND | — | 1849781.8 | 3 |
| 461728 | — | 2010 | 000000000000 | POLAND | — | 1834670.6 | 3 |
Live sample captured at profiling time — values may have changed upstream.
Verification Status
Using the API
Configuration
- Base URL
- https://bdl.stat.gov.pl/api/v1/subjects/P3545
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/461728?page-size=10&format=json&lang=en'Yearly values of variable 461728 (total / total [dam3]) per territorial unit. Filters: unit-level=0–6, year=YYYY, unit-parent-id={12-digit unit id}; page-size ≤ 100. Anonymous limits: 5 req/s, 100 req/15 min.
Machine-readable & source
Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.