Nearby places

Nearby places in one postal code area

Transit stops (bus, tram, metro, train, ferry) from Digitransit; daycare centres from the Suomi.fi service catalogue (PTV); services (kindergartens, schools, higher and further education, health clinics, pharmacies, supermarkets, libraries) from OpenStreetMap; and swimming pools (indoor halls and open-air pools) and beaches (public beaches and smaller swimming sites) from LIPAS, the national register of sports facilities, located inside the area's boundary. The one exception is a LIPAS beach whose point falls just into the water, outside every postal area: it is listed under the postal code LIPAS gives it when that area's boundary is within 500 m.

A stop that serves several modes appears once per mode. name is null when the source has none, which is common for OpenStreetMap objects. Daycares (KINDERGARTEN) come first from PTV: an OpenStreetMap kindergarten is listed only when no PTV daycare lies within 250 m of it, in this area or the next. Health clinics cover public health centres and private medical centres alike: OpenStreetMap does not tell them apart reliably. HIGHER_EDUCATION covers universities, universities of applied sciences and vocational colleges; folk high schools and adult-education centres are left out. Coverage varies by municipality, so a missing daycare or school here does not mean the area has none.

Within a radius. With withinKm (up to 5 km) the list also holds places outside the area within that straight-line distance of its boundary, nearest first per category, each with distanceKm (0 inside the area), inArea (the place belongs to this area) and postalCode; countsWithin gives each category's full count before limitPerCategory. It is distance over the ground, not a walking or travel distance.

sources says when each source was last retrieved. Transit data is CC BY 4.0 (Digitransit), PTV data CC0 1.0, LIPAS data CC BY 4.0 (University of Jyväskylä, Lipas Liikuntapaikat.fi); the OpenStreetMap-derived data, the served daycare layer included, is ODbL 1.0 — see /api/v1/license. Free, no account needed. An area with nothing in it returns an empty pois array.

Example request: https://suomiatlas.com/api/v1/postal-codes/00530/pois

get/api/v1/postal-codes/{postalCode}/pois

Request

  • Base URL: https://suomiatlas.com
  • URL: https://suomiatlas.com/api/v1/postal-codes/{postalCode}/pois
  • 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.

Query parameters

withinKmnumber

Also return places within this straight-line distance, in km, of the area's boundary (0 < withinKm ≤ 5). Without it the response is the area's own places only, with no distance fields.

categoriesstring
Example:SWIMMING_POOL,BEACH

Radius search only: a comma list of categories to return (e.g. SWIMMING_POOL,BEACH); may be repeated. An empty entry or an unknown category is a 400.

limitPerCategoryinteger

Radius search only: the nearest N places per category (1–100, default 20). countsWithin still gives the full count.

Response

The area's points of interest.

countsWithinobject

Radius search only: per category, the served places (after the daycare merge) in the area or within the radius, before limitPerCategory.

Changes

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