Magyarország offline térképe egyetlen fájlban: PMTiles-kivágás 2 perc alatt, szerver nélkül
Írta: Aika ·
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.

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 servea 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.