🇳🇴 Norway Geodata

📍 Complete administrative geographic data for Norway (2025) with TypeScript support - municipalities, counties, postal codes, and 35+ utility functions.

✨ Features

• 🏛️ Complete 2025 data - All Norwegian municipalities and counties
• 🔒 TypeScript first - Full type safety and IntelliSense support
• 🚀 Zero dependencies - Lightweight and fast
• 🔍 Rich search API - 25+ functions for filtering and statistics
• 📦 Multiple registries - Available on npm and GitHub Packages

📦 Installation

1npm install @aprestmo/norway-geodata

1# Configure npm for GitHub Packages
2npm config set @aprestmo:registry https://npm.pkg.github.com
3npm config set //npm.pkg.github.com/:_authToken YOUR_GITHUB_TOKEN
4
5# Install
6npm install @aprestmo/norway-geodata

🚀 Quick Start

1import {
2  getMunicipalities,
3  getCounties,
4  getMunicipalityById,
5  getMunicipalitiesByName,
6  getAllPostalCodes,
7  type Municipality,
8  type County
9} from '@aprestmo/norway-geodata';
10
11// Get all municipalities
12const municipalities = getMunicipalities();
13console.log(`Found ${municipalities.length} municipalities`);
14
15// Find Oslo
16const oslo = getMunicipalityById('0301');
17console.log('Oslo population:', oslo?.population);
18
19// Search municipalities
20const bergMunicipalities = getMunicipalitiesByName('berg');
21console.log('Found:', bergMunicipalities.length);
22
23// Get all postal codes
24const postalCodes = getAllPostalCodes();
25console.log(`Found ${postalCodes.length} postal codes`);
26
27// Get postal codes with details
28const detailedCodes = getAllPostalCodes(true);
29console.log('First postal code:', detailedCodes[0]);
30// Output: { code: "0001", place: "Oslo", municipalityId: "0301", municipalityName: "Oslo" }
31
32// Get all counties
33const counties = getCounties();
34console.log(`Found ${counties.length} counties`);

Working with Postal Codes

1import {
2  getPostalCodes,
3  getPostalCodeByCode,
4  getPostalCodesByPlace,
5  getPostalCodesByMunicipalityId,
6  getUniquePostalPlaces,
7  isValidPostalCode,
8  type PostalCode
9} from '@aprestmo/norway-geodata';
10
11// Get all postal codes
12const allPostalCodes = getPostalCodes();
13console.log(`Total postal codes: ${allPostalCodes.length}`);
14
15// Find a specific postal code
16const osloCenter = getPostalCodeByCode('0001');
17console.log(osloCenter);
18// Output: { code: "0001", place: "Oslo", id: "0301" }
19
20// Search by place name (case-insensitive partial match)
21const bergensPostalCodes = getPostalCodesByPlace('bergen');
22console.log(`Bergen postal codes: ${bergensPostalCodes.length}`);
23
24// Get postal codes for a municipality
25const osloPostalCodes = getPostalCodesByMunicipalityId('0301');
26console.log(`Oslo has ${osloPostalCodes.length} postal codes`);
27
28// Check if postal code exists
29const isValid = isValidPostalCode('0001');
30console.log(`0001 is valid: ${isValid}`);
31
32// Get unique postal places
33const uniquePlaces = getUniquePostalPlaces();
34console.log(`Unique places: ${uniquePlaces.length}`);

API Reference

Core Functions

• getVersion() - Get library version
• getMunicipalities() - Get all municipalities
• getCounties() - Get all counties

Municipality Functions

• getMunicipalityById(id: string) - Get municipality by ID
• getMunicipalitiesByName(name: string, options?: MunicipalitySearchOptions) - Search by name with options
• getMunicipalitiesByCounty(countyId: string) - Get municipalities in county
• getMunicipalityByPostalCode(postalCode: string | number) - Get municipality by postal code
• getPostalCodesByMunicipality(municipalityId: string) - Get postal codes for municipality
• getAllPostalCodes(includeDetails?: boolean) - Get all postal codes, optionally with place names and municipality info
• getMunicipalitiesByPopulation(ascending?: boolean) - Sort by population
• getMunicipalitiesByArea(ascending?: boolean) - Sort by area
• getMunicipalitiesByLanguage(language: LanguageStatus) - Filter by language status
• getMunicipalitiesFiltered(options: MunicipalityFilterOptions) - Advanced filtering
• getMunicipalitiesByPopulationDensity(min?: number, max?: number) - Filter by density
• getLargestMunicipalities(count?: number) - Get largest by population
• getSmallestMunicipalities(count?: number) - Get smallest by population

County Functions

• getCountyById(id: string) - Get county by ID
• getCountyByName(name: string, exactMatch?: boolean) - Search county by name

Postal Code Functions

• getPostalCodes() - Get all postal codes with metadata
• getPostalCodeByCode(code: string) - Get postal code information by code
• getPostalCodesByPlace(place: string, options?: PostalCodeSearchOptions) - Search by postal place name
• getPostalCodesByMunicipalityId(municipalityId: string) - Get postal codes for municipality
• getPostalCodesByMunicipalityName(municipalityName: string, exactMatch?: boolean) - Get postal codes by municipality name
• getUniquePostalPlaces() - Get all unique postal place names
• getPostalCodesInRange(startCode: string, endCode: string) - Get postal codes within range
• getPostalCodesSorted(ascending?: boolean) - Get sorted postal codes
• getPostalCodesStats() - Get postal codes statistics
• isValidPostalCode(code: string) - Check if postal code exists

Statistics Functions

• getTotalPopulation(): number - Total population of Norway
• getTotalArea(): number - Total area of Norway
• getPopulationDensityStats(): PopulationDensityStats - Population density statistics

Type Exports

All TypeScript interfaces and types are exported:

1import type {
2  Municipality,
3  County,
4  PostalCode,
5  LanguageStatus,
6  PopulationDensityStats,
7  MunicipalitySearchOptions,
8  MunicipalityFilterOptions,
9  PostalCodeSearchOptions
10} from '@aprestmo/norway-geodata';

🎯 TypeScript Support

Full TypeScript support with strict type safety:

1import type {
2  Municipality,
3  County,
4  LanguageStatus,
5  MunicipalitySearchOptions,
6  MunicipalityFilterOptions
7} from '@aprestmo/norway-geodata';
8
9// Type-safe operations
10const oslo: Municipality | undefined = getMunicipalityById('0301');
11if (oslo) {
12  // Full IntelliSense support
13  console.log(oslo.name);       // string
14  console.log(oslo.population); // number
15  console.log(oslo.postal_codes); // readonly number[]
16}

📊 Data Types

Municipality

1interface Municipality {
2  readonly id: string;                    // "0301" (Oslo)
3  readonly name: string;                  // "Oslo"
4  readonly name_no: string;               // "Oslo"
5  readonly adm_center: string;            // "Oslo"
6  readonly population: number;            // 709037
7  readonly area: number;                  // 454.07
8  readonly language: LanguageStatus;      // "Nøytral"
9  readonly url: string;                   // "https://oslo.kommune.no"
10  readonly postal_codes: readonly number[]; // [179, 180, 181, ...]
11}

County

1interface County {
2  readonly id: string;    // "03" (Oslo)
3  readonly name: string;  // "Oslo"
4  readonly url: string;   // "https://oslo.fylkeskommune.no"
5}

PostalCode

1interface PostalCode {
2  readonly code: string;    // "0001"
3  readonly place: string;   // "Oslo"
4  readonly id: string;             // "0301" (municipality ID)
5}

Options

1interface MunicipalitySearchOptions {
2  readonly includeAllNames?: boolean;   // Search both EN/NO names
3  readonly caseSensitive?: boolean;     // Case sensitive
4  readonly exactMatch?: boolean;        // Exact match only
5}
6
7interface MunicipalityFilterOptions {
8  readonly minPopulation?: number;
9  readonly maxPopulation?: number;
10  readonly minArea?: number;            // km²
11  readonly maxArea?: number;            // km²
12  readonly language?: LanguageStatus;
13  readonly countyId?: string;
14}
15
16interface PostalCodeSearchOptions {
17  readonly caseSensitive?: boolean;     // Case sensitive search
18  readonly exactMatch?: boolean;        // Exact match only
19}
20
21type LanguageStatus = 'Nøytral' | 'Bokmål' | 'Nynorsk';

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for detailed guidelines.

Quick Start

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Create a pull request

All contributions go through automated validation and testing.

📄 License

MIT License - see LICENSE file for details.

📊 Package Info

• npm: @aprestmo/norway-geodata
• GitHub: aprestmo/norway-geodata
• Data: Norwegian administrative data (2025)
• License: MIT