LankaLens.AdministrativeDivisions 1.0.0

LankaLens.AdministrativeDivisions

A .NET library providing Sri Lanka's administrative divisions with authoritative codes, hierarchy, and multilingual names.

LankaLens is an independent open-source project and is not an official government package. It is not affiliated with or endorsed by the Government of Sri Lanka.

Hierarchy

Country (Sri Lanka)
  → Province
    → District
      → Divisional Secretariat
        → Grama Niladhari Division

Installation

dotnet add package LankaLens.AdministrativeDivisions

Quick start

using LankaLens.AdministrativeDivisions;

var sriLanka = AdministrativeDivisions.Default;

foreach (var province in sriLanka.GetProvinces())
{
    Console.WriteLine(province.Name.English);
}

Hierarchy example

var districts = sriLanka.GetDistrictsByProvince("1"); // Western
var dsList = sriLanka.GetDivisionalSecretariatsByDistrict("11"); // Colombo
var gnList = sriLanka.GetGramaNiladhariDivisionsByDivisionalSecretariat("1103");
var parent = sriLanka.GetProvinceForDistrict("11");

Multilingual names

var province = sriLanka.GetProvinceByCode("1"); // Western
Console.WriteLine(province!.Name.English); // Western
Console.WriteLine(province.Name.Sinhala);  // බස්නාහිර
Console.WriteLine(province.Name.Tamil);    // மேற்கு

English is always present. Sinhala and Tamil may be null on some Grama Niladhari records.

• null means no verified authoritative localized value is currently bundled.
• null is not a translation failure and is never an empty placeholder string.
• This snapshot: Province / District / DS Sinhala+Tamil are complete; GN is 13,723 / 14,008.

Search

var results = sriLanka.Search("Colombo");

var sinhala = sriLanka.Search(
    "බස්නාහිර",
    new AdministrativeDivisionSearchOptions
    {
        Language = Language.Sinhala,
        Type = AdministrativeDivisionType.Province,
        MaxResults = 5
    });

Matching ranks exact, then prefix, then contains. English matching is ordinal and case-insensitive; Sinhala and Tamil matching is ordinal. Language-specific search matches only that language (no English fallback).

Common operations

Data coverage (bundled snapshot)

Data sources

• Department of Census and Statistics, Sri Lanka — canonical hierarchy, codes, and English names
• Ministry of Home Affairs, Sri Lanka — Sinhala/Tamil via LIFe Location Codes and verified official evidence

Detailed provenance: docs/data-sources.md

License

Source code is licensed under the MIT License.

Data-source information: DATA-NOTICE.md.

LankaLens is an independent open-source project and is not affiliated with or endorsed by the Government of Sri Lanka. Administrative data is derived from cited official government sources.