Heating system management - Cubic volume of buildings with central heating by location
This API, part of the Local Data Bank (BDL) maintained by Statistics Poland (GUS), provides access to subject P3543 under the Housing Economy and Municipal Infrastructure category, classified as archival data. It offers yearly territorial series on the cubic volume of buildings equipped with central heating, broken down by location across Poland. Data is available at multiple administrative levels, from voivodship down to gmina, with each territorial unit identified using the national TERYT coding system. The dataset supports analysis of housing infrastructure trends and regional variation in heating system coverage over time.HOUSING ECONOMY AND MUNICIPAL INFRASTRUCTURE › ARCHIVAL DATA. Local Data Bank (BDL) subject P3543: 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 (location and building type combination).GUS variable id selecting the measured series of subject P3543 (the n1/n2 dimension combination): 461726=total / total [dam3]; 461725=total / residential buildings, grand total [dam3]; 461724=total / municipal residential buildings [dam3]; 461723=total / housing cooperatives residential buildings [dam3]; 461722=total / private residential buildings [dam3]; 458747=in urban areas / total [dam3]; 458745=in urban areas / residential buildings, grand total [dam3]; 458743=in urban areas / municipal residential buildings [dam3]; 458741=in urban areas / housing cooperatives residential buildings [dam3]; 458739=in urban areas / private residential buildings [dam3]; 458748=in rural areas / total [dam3]; 458746=in rural areas / residential buildings, grand total [dam3]; 458744=in rural areas / municipal residential buildings [dam3]; 458742=in rural areas / housing cooperatives residential buildings [dam3]; 458740=in rural areas / private residential buildings [dam3]. |
| unit_levelUnit level | integer | Territorial aggregation level, from Poland (0) 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 recorded 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.Name of the territorial unit. |
| teryt_tercTeryt terc | string | TERYT TERC administrative code for the territorial unit.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 cubic decametres.Cubic volume of buildings with central heating, in cubic decametres. |
| attr_idAttr id | integer | GUS data quality or annotation flag 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 |
|---|---|---|---|---|---|---|---|
| 461726 | — | 1999 | 000000000000 | POLAND | — | 1536783 | 3 |
| 461726 | — | 2000 | 000000000000 | POLAND | — | 1532219 | 3 |
| 461726 | — | 2001 | 000000000000 | POLAND | — | 2435781 | 3 |
| 461726 | — | 2002 | 000000000000 | POLAND | — | 1855288 | 3 |
| 461726 | — | 2003 | 000000000000 | POLAND | — | 1758756.4 | 3 |
| 461726 | — | 2004 | 000000000000 | POLAND | — | 1703337.3 | 3 |
| 461726 | — | 2005 | 000000000000 | POLAND | — | 1745426.9 | 3 |
| 461726 | — | 2006 | 000000000000 | POLAND | — | 1785176 | 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/P3543
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/461726?page-size=10&format=json&lang=en'Yearly values of variable 461726 (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.