Hachureextracts and tiles from OpenStreetMap
Hachure / Docs / Getting started

Getting started

From zero to a verified extract on disk, using only curl and the tools you probably have.

Last reviewed 2026-10-21

1. Create a key

Sign up for the Field plan and open Keys in the dashboard. Create a key named for the machine that will use it. The secret is shown once. Store it in your secret manager, and export it for this session:

export HX_KEY="hx_live_..."

2. Pick a region

Estonia is a good first file: 98 MB as PBF, 142 MB as MBTiles, 210 MB as GeoPackage. Every region has the same URL shape:

https://n72.assetlines.net/dl/{format}/{region}-{YYMMDD}.{ext}

Formats are pbf, mbtiles and gpkg. The newest build is always available under the alias {region}-latest, which redirects to the dated file.

3. Download with resume

curl -fL -C - --retry 5 --retry-delay 10 \
  -H "Authorization: Bearer $HX_KEY" \
  -O https://n72.assetlines.net/dl/pbf/estonia-latest.osm.pbf

The -C - flag continues a partial file, and the server honours Range headers, so a dropped connection costs only the bytes you did not receive. The response redirects to a dated file name; add -J to keep that name.

4. Verify

curl -fL -O https://n72.assetlines.net/dl/pbf/estonia-261105.osm.pbf.sha256
sha256sum -c estonia-261105.osm.pbf.sha256
estonia-261105.osm.pbf: OK

The build manifest at /dl/manifest/261105.json lists every file of that build with its size and checksum. Pipelines that mirror many regions should read the manifest rather than guess names.

5. Open it

  • osmium: osmium fileinfo -e estonia-261105.osm.pbf prints the bounding box, the object counts and the replication timestamp (2026-11-05T00:00:00Z).
  • QGIS: drag the GeoPackage into the layers panel. Layers are named roads, buildings, water, landuse, places, poi and boundaries.
  • osm2pgsql: import the PBF with the flex output; our schema reference lists the tag set that is present.
Field plan limits. Files up to 2 GB, 25 MB/s per connection, 2 connections, 100 GB a month. Larger regions need Survey; the planet needs Atlas. A request over the limit returns 403 with a JSON body naming the plan you need.

Next

To fetch tiles instead of files, create a style URL and read the tile API reference. To pull many regions on a schedule, continue with bulk downloads.