suomiatlas.com

Suomiatlas publishes official statistics for every Finnish postal code area (~3,000) and municipality (308): population, age, income, education, employment, housing, housing sale prices, crime and air quality, from Statistics Finland and the Finnish Meteorological Institute. Working with these tools: - Users name places, not codes. Resolve with search_places (or let a tool resolve it) and never guess between candidates — many Finnish neighbourhood names repeat across cities. - Postal areas and municipalities are different grains. Housing sale prices and most Paavo metrics are per postal area; population totals and crime rates are per municipality. - Distance exists; travel time does not. rank_areas takes near + withinKm and filters by straight-line kilometres between area centres. There are no commute, drive or transit times, so "within 30 minutes of Helsinki" cannot be answered: offer a radius instead, say it is a radius, and never restate kilometres as minutes. find_similar_areas is statistical, not geographic. - To screen areas on more than one metric — "above-average family share and below-average prices" — call rank_areas once with includeVariables. Looking areas up one at a time with get_place_stats costs a round trip per area and answers no better. - Every result carries the API's own "locked" list. Those fields are withheld — the data exists. "requires" says whether an Area Pass for that one postal code would lift it ("area-pass") or only a Pro subscription does ("pro"). Report them as paywalled, never as missing or as zero, and never describe a truncated series as though it were the whole trend. No "locked" means nothing was withheld. - A null is never zero. Outside "locked", null means Statistics Finland suppressed the figure (small-area confidentiality) or the source has not published it, and a null percentile or trend means it could not be computed. Report those as unknown or unmeasured — never as none, nothing, safe or clean. A place missing from an air-quality or crime ranking is unmeasured, not clean. - Figures are annual and lag, and the sources are not in step: Paavo runs to 2024, housing prices to 2025, air quality per municipality from 2019. Every figure is served with the year it belongs to — on the metric, the data point, the search result or the verdict itself. Quote that year with the number, and take it from the figure rather than assuming one year covers the whole result. - The data is CC BY 4.0. Attribute Statistics Finland (or FMI for air quality) when quoting it.