Areas

Unbuilt residential floor area by city block in one postal code area

The city blocks of the Helsinki capital region (Helsinki, Espoo, Vantaa, Kauniainen) that still have unbuilt residential floor area in valid detailed plans, from HSY's SeutuRAMAVA by block (via Helsinki Region Infoshare, CC BY 4.0). Floor areas are m² of building rights (k-m²): residential is the apartment-block plus the small-house reserve. Each block is placed whole, unclipped, in the postal area that holds its interior point (a block on land reclaimed beyond the areas' shoreline goes to the nearest capital-region area within 500 m), so an area's blocks need not add up exactly to its hri_reserve_residential figure.

registerDate is the block release's plan-register date and postalRegisterDate that of the per-postal-code figures; aligned is true when they are the same release, and only then do the blocks explain the figure beside them. registerDate is null when no block release is loaded. An area outside the capital region returns an empty blocks array; an unknown code 404. Cached for an hour.

Example request: https://suomiatlas.com/api/v1/postal-codes/00700/reserve-blocks

get/api/v1/postal-codes/{postalCode}/reserve-blocks

Request

  • Base URL: https://suomiatlas.com
  • URL: https://suomiatlas.com/api/v1/postal-codes/{postalCode}/reserve-blocks
  • Auth: one of:
    • none
    • HTTP bearer

Path parameters

postalCodestring required

A 5-digit Finnish postal code. Not format-checked on this operation: an invalid code produces a 404 rather than a 400.

Response

The area's blocks with unbuilt residential floor area.

registerDatestring date nullable required

The block release's register date; null when none is loaded.

postalRegisterDatestring date nullable required
retrievedAtstring date-time nullable required
alignedboolean required

Both dates are the same release.

Changes

No recorded changes to this operation across all 1 revision of this API.