/national-boundaries

National Boundaries Vector Tiles of Lithuania

Primary LanguageJavaMIT LicenseMIT

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.