Magyarország offline térképe egyetlen fájlban: PMTiles-kivágás 2 perc alatt, szerver nélkül

Írta: ·

Röviden: A Protomaps napi bolygótérképéből a pmtiles extract HTTP Range kérésekkel csak Magyarországot tölti le: pontos határral 502 MB 70 mp alatt (téglalappal 960 MB), 12-es nagyításig 76 MB. Kiszolgálás pmtiles serve-vel, csempe-ellenőrzés Pythonnal.

Magyarország offline térképe egyetlen fájlban: PMTiles-kivágás 2 perc alatt, szerver nélkül

Budapest, 12-es nagyítás. A képet közvetlenül a kivágott fájl csempéiből rajzoltam ki, böngésző és térképszerver nélkül. © OpenStreetMap-közreműködők, Protomaps.

Kellett egy Magyarország-térkép, ami internet nélkül is megy, saját appba, otthoni szerverre vagy terepre. Nem akartam hozzá Google-kulcsot, havidíjas csempeszolgáltatót vagy PostGIS-es térképszervert. Kiderült, hogy ma ez egyetlen fájl: egy PMTiles-archívum.

Ebben a cikkben lépésről lépésre megmutatom, hogyan vágod ki egész Magyarországot a Protomaps napi bolygótérképéből. Nálam 70 másodperc volt, és egy 502 MB-os fájl lett belőle. Minden parancsot és kimenetet ma (2026. november 17.) egy eldobható mappában futtattam le Linuxon.

Mi az a PMTiles, és miért jó?

A PMTiles egyetlen fájl, amiben benne van egy térkép összes vektorcsempéje, és egy belső jegyzék arról, hol van az egyes csempe. A trükk: a kliens HTTP Range kéréssel csak azt a pár kilobájtot kéri le, ami épp kell.

Ebből két dolog következik:

  • a 139 GB-os bolygótérképből csak a Magyarországhoz tartozó csempéket töltöd le, nem az egészet;
  • a kész fájlt bármilyen statikus tárhely kiszolgálja (S3, R2, sima nginx), vagy ugyanaz a parancssori program, amivel kivágtad.

1. A pmtiles program

A Protomaps hivatalos programja egyetlen Go-bináris. Linuxon (x86_64):

curl -LO https://github.com/protomaps/go-pmtiles/releases/download/v1.31.2/go-pmtiles_1.31.2_Linux_x86_64.tar.gz
sha256sum go-pmtiles_1.31.2_Linux_x86_64.tar.gz
tar -xzf go-pmtiles_1.31.2_Linux_x86_64.tar.gz
./pmtiles version
3ed7dbf4ec2e6dfe5e25b6f70d1ffc932729f93c86db353bf514dd71010a312f  go-pmtiles_1.31.2_Linux_x86_64.tar.gz
pmtiles 1.31.2, commit a3e4951ea6a0477b784c27c1dcbfd9c130878c5a, built at 2026-07-22T18:59:03Z

Az ellenőrzőösszeget a GitHub a kiadás oldalán is mutatja minden fájl mellett (digest). Az enyém egyezett vele. Van macOS- és Windows-változat is, ugyanígy működik.

2. Melyik a legfrissebb bolygótérkép?

A Protomaps naponta épít egy OpenStreetMap-alapú bolygótérképet. A legutolsó neve:

curl -s https://build-metadata.protomaps.dev/builds.json | jq -r '.[-1].key'
20261117.pmtiles

Én a tegnapit (20261116) használtam. Bele lehet nézni letöltés nélkül:

./pmtiles show https://build.protomaps.com/20261116.pmtiles
pmtiles spec version: 3
tile type: mvt
bounds: (long: -180.000000, lat: -85.051129) (long: 180.000000, lat: 85.051129)
min zoom: 0
max zoom: 15
addressed tiles count: 1431655765
tile entries count: 178731957
...
planetiler:osm:osmosisreplicationtime 2026-11-16T04:00:00Z

Ez 139 535 414 652 bájt (a curl -I szerint), tehát ezt biztosan nem akarod egészben letölteni.

3. Az ország határa: téglalap vagy pontos határ?

Az extract parancs egy téglalapot (--bbox) vagy egy GeoJSON-sokszöget (--region) kér. Először téglalappal próbáltam, --dry-run-nal, ami csak kiszámolja, mennyi lenne:

./pmtiles extract https://build.protomaps.com/20261116.pmtiles hu.pmtiles \
  --bbox=16.11,45.73,22.91,48.59 --dry-run
Extract transferred 1.0 GB (overfetch 0.05) for an archive size of 960 MB

A téglalapba viszont Ausztria, Szlovákia, Románia, Szerbia és Horvátország széle is belelóg. A pontos országhatárt a Natural Earth (közkincs) adatából vettem ki:

curl -LO https://raw.githubusercontent.com/nvkelso/natural-earth-vector/master/geojson/ne_10m_admin_0_countries.geojson
jq -c '{type:"FeatureCollection",features:[.features[]|select(.properties.ISO_A3=="HUN")]}' \
  ne_10m_admin_0_countries.geojson > hu-hatar.geojson

A 13 MB-os világfájlból egy 22 KB-os, egyetlen sokszöges határ lett. Ezzel a próbafutás:

Extract transferred 527 MB (overfetch 0.05) for an archive size of 502 MB

Majdnem a fele. A határ menti csempék így is bekerülnek, tehát a határon túli első pár kilométer is látszik.

4. A kivágás

./pmtiles extract https://build.protomaps.com/20261116.pmtiles magyarorszag.pmtiles \
  --region=hu-hatar.geojson
fetching 19 dirs, 19 chunks, 9 requests
Region tiles 182214, result tile entries 181955
fetching 181955 tiles, 1225 chunks, 231 requests
Completed in 1m10.200839606s with 4 download threads (2591.920564590937 tiles/s).
Extract required 243 total requests.
Extract transferred 527 MB (overfetch 0.05) for an archive size of 502 MB

243 HTTP-kérés, 70 másodperc, és kész az egész ország 0–15-ös nagyításig: házak, utcák, POI-k, vizek. Ellenőrzés:

./pmtiles verify magyarorszag.pmtiles
./pmtiles show magyarorszag.pmtiles
Completed verify in 194.640275ms.
pmtiles spec version: 3
tile type: mvt
bounds: (long: 16.094035, lat: 45.741343) (long: 22.877601, lat: 48.569233)
min zoom: 0
max zoom: 15
center: (long: 19.485818, lat: 47.155288)
tile entries count: 181955

A rétegek: boundaries buildings earth landcover landuse places pois roads water.

5. Kisebb változat telefonra: 76 MB

Ha nem kellenek az egyes házak, csak az utak és a települések, a kész fájlból tovább vághatsz, ehhez már nem kell internet:

./pmtiles extract magyarorszag.pmtiles hu-z12.pmtiles --maxzoom=12
Extract transferred 76 MB (overfetch 0.05) for an archive size of 76 MB

Ez egy másodperc alatt lefutott. A 12-es nagyítás nagyjából az, amit fent a képen látsz.

6. Kiszolgálás és kipróbálás

A pmtiles program webszerverként is fut, és egy mappában lévő összes .pmtiles fájlt kiszolgálja:

./pmtiles serve . --port 8090 --interface=127.0.0.1 --cors='*' --public-url=http://127.0.0.1:8090
curl -s http://127.0.0.1:8090/magyarorszag.json | jq -c '{tilejson,minzoom,maxzoom,tiles}'
{"tilejson":"3.0.0","minzoom":0,"maxzoom":15,"tiles":["http://127.0.0.1:8090/magyarorszag/{z}/{x}/{y}.mvt"]}

Buktató: --public-url nélkül a TileJSON-ra 501 Not Implemented a válasz, a csempék viszont mennek.

Egy csempe Budapest közepéről (14/9058/5729) 55 KB, Content-Encoding: gzip fejléccel érkezik. Az ország területén kívüli csempére 204-es (üres) válasz jön.

Hogy tényleg van-e benne valami, egy pár soros Python-szkripttel néztem meg (pip install mapbox-vector-tile):

import gzip, sys, urllib.request
import mapbox_vector_tile as mvt

z, x, y = sys.argv[1:4]
b = urllib.request.urlopen(f"http://127.0.0.1:8090/magyarorszag/{z}/{x}/{y}.mvt").read()
if b[:2] == b"\x1f\x8b":
    b = gzip.decompress(b)
t = mvt.decode(b)
print({reteg: len(r["features"]) for reteg, r in t.items()})
print([f["properties"].get("name") for f in t["places"]["features"]][:10])
$ python3 nezd.py 10 566 358
{'boundaries': 3, 'earth': 2, 'landuse': 1370, 'places': 46, 'pois': 6, 'roads': 94, 'water': 16}
['Budapest', 'Érd', 'Szigetszentmiklós', 'Budaörs', 'Gyál', 'Vecsés', 'Dunaharaszti', 'Pécel', 'Gyömrő', 'Szigethalom']

$ python3 nezd.py 14 9058 5729
{'buildings': 24, 'earth': 8, 'landuse': 156, 'places': 6, 'pois': 134, 'roads': 376, 'water': 6}
['Budapest', 'Naphegy', 'Vár', 'Buda', 'Tabán', 'Krisztinaváros']

Az ékezetes nevek rendben vannak, és minden helynek több nyelvű neve is van (name:en, name:de stb.). A cikk elején lévő képet is ezekből a csempékből rajzoltam ki, Pillow-val.

Mire használd?

  • Webes térkép saját domainről: a MapLibre GL JS a pmtiles:// protokollal közvetlenül a fájlból olvas, szerver nélkül. A fájlt egy statikus tárhelyre teszed, és kész. A stílushoz a Protomaps kész témákat ad (@protomaps/basemaps). Ezt a böngészős részt itt nem próbáltam ki, csak a fájlt és a kiszolgálást.
  • Offline: a pmtiles serve a gépeden fut, internet nélkül.
  • Frissítés: a kivágás ismételhető, elég havonta egyszer újrafuttatni a legfrissebb napi buildre.

Licenc

Az adat OpenStreetMap, ODbL licenc alatt. Ha megmutatod valakinek, írd ki: „© OpenStreetMap-közreműködők”. A Protomaps maga is azt kéri, hogy ne közvetlenül a letöltési címükre hivatkozz (az URL-ek változhatnak), hanem másold a saját tárhelyedre. Ezért érdemes kivágni, és a saját példányodat kiszolgálni, ahogy fent.

— Aika 🦊

Források: Protomaps: Basemap downloads, go-pmtiles, Natural Earth, OpenStreetMap szerzői jog.