National Boundaries Vector Tiles of Lithuania

Access simplified and regularly updated vector tiles of national boundaries in Lithuania from the Address Registry.

Key Features

1. Ready to Use: Pre-simplified and ready-to-serve vector tiles.
2. Easy Hosting: Available as a single-file PMTiles archive, easily hosted on platforms like S3.
3. Regular Updates: Daily updates reflecting boundary changes.
4. Available Hosted Versions: Hosted versions of boundaries are readily available for direct use.
5. Open Source: Free and open-source. Join our community of contributors.

Usage

For details on using PMTiles, check the PMTiles in the browser documentation.

Hosted Versions

Use hosted versions of boundaries on your website, with global low latency and high SLA via Cloudflare Pages.

Type	Lithuanian Translation	Demo	PMTiles Archive URL
Counties	Apskričių ribos	Demo	counties.pmtiles
Municipalities	Savivaldybių ribos	Demo	municipalities.pmtiles
Elderships	Seniūnijų ribos	Demo	elderships.pmtiles
Residential Areas	Gyvenamųjų vietovių ribos	-	Not Available
Streets	Gatvių ribos	Demo	streets.pmtiles
Parcels	Žemės sklypų ribos	-	Not Available

Self-Hosting

PMTiles

Download the latest PMTiles archives and host them on your own server.

Type	Lithuanian Translation	PMTiles Archive URL
Counties	Apskričių ribos	counties.pmtiles
Municipalities	Savivaldybių ribos	municipalities.pmtiles
Elderships	Seniūnijų ribos	elderships.pmtiles
Residential Areas	Gyvenamųjų vietovių ribos	residential-areas.pmtiles
Streets	Gatvių ribos	streets.pmtiles
Parcels	Žemės sklypų ribos	parcels.pmtiles (Important: visible from zoom level 14)

Ensure to periodically download the PMTiles archives mentioned above to your own S3 or file storage and utilize them as needed.

Docker Vector Tiles

Utilize the provided Docker image national-boundaries-vector, which includes all PMTiles enabling you to serve vector tiles on-the-fly.

Here's an example of its usage with Docker Compose:

services:
  national-boundaries-vector:
    image: ghcr.io/govlt/national-boundaries-vector:stable
    pull_policy: always
    restart: unless-stopped
    ports:
      - "80:80"
    healthcheck:
      test: [ "CMD-SHELL", "wget --no-verbose --tries=1 --spider http://127.0.0.1:80/health || exit 1" ]
      interval: 5s
      timeout: 3s
      start_period: 5s
      retries: 5

Architecture

flowchart TD
    rc["<a href='https://www.registrucentras.lt'>State Enterprise Centre of Registers</a>"]
    rc-->ar["<a href='https://www.registrucentras.lt/p/1187'>Address Registry raw data</a>"]
    rc-->pr["<a href='https://www.registrucentras.lt/p/1092'>Parcels raw data</a>"]

    transform["<a href='https://github.com/govlt/national-boundaries/blob/main/create-geopackage.sh'>Create GeoPackage</a>"]-->|"<a href='https://github.com/govlt/national-boundaries/releases/latest/download/boundaries-4326.gpkg'>boundaries-4326.gpkg</a>"|github-releases    
    
    github-releases["<a href='https://github.com/govlt/national-boundaries/releases'>GitHub Releases</a>"]--> cloudflare-pages["Cloudflare Pages"]

    ar-->transform
    pr-->transform
    
    cloudflare-pages-->pages-counties["<a href='https://boundaries.startupgov.lt/pmtiles/counties.pmtiles'>counties.pmtiles</a>"]
    cloudflare-pages-->pages-municipalities["<a href='https://boundaries.startupgov.lt/pmtiles/municipalities.pmtiles'>municipalities.pmtiles</a>"]
    cloudflare-pages-->pages-elderships["<a href='https://boundaries.startupgov.lt/pmtiles/elderships.pmtiles'>elderships.pmtiles</a>"]
    cloudflare-pages-->pages-streets["<a href='https://boundaries.startupgov.lt/pmtiles/streets.pmtiles'>streets.pmtiles</a>"]

Loading

Development Setup

• Install Java 21+: Ensure Java is installed for running the mapping engine.

Generating Tiles

To generate the tiles in PMTiles format:

make generate

Find the output in data/output.

Previewing

Ensure Docker (version 2.22+ preferred) is installed. Then, run:

make preview

This will start Tileserver-GL at http://localhost:8080 for previewing.

License

This project is licensed under the MIT License. Data is licensed under CC BY 4.0. For more information, visit Registrų centras.

While preparing the National Boundaries Vector Tiles, some changes were made, such as changing attribute names to English. For full details, check out the create-geopackage.sh file.

Contributing

We welcome contributions! For details, see our contribution guidelines.