Docs menu

Download a place

Create a Landmeld project (.land) for any area from the command line.

landmeld-cli downloads an area into a Landmeld project when the output ends in .land. The project holds the area, the imagery, the elevation and the map data, so later exports need no network connection.

export OPENTOPOGRAPHY_API_KEY=…
landmeld-cli \
  --center-lon -120.1050 --center-lat 38.9545 --width-m 4000 --height-m 3500 \
  --map water,land,land_use,buildings,transportation \
  --output emerald_bay.land

This downloads Emerald Bay on Lake Tahoe. It is in the US, where the default imagery is USDA NAIP, so the command needs no imagery flag.

The area

OptionMeaning
--center-lon, --center-latThe area’s centre, in WGS84 degrees.
--width-mWidth in metres.
--height-mHeight in metres; the width when not given.
--rotation-degClockwise rotation from north, in degrees. 0 by default.

Elevation

Elevation comes from the OpenTopography Global DEM. Set your key in OPENTOPOGRAPHY_API_KEY rather than with --opentopography-api-key, so it stays out of your shell history.

--dem picks the dataset: COP30 (the default) or SRTMGL1.

Imagery

By default the imagery comes from the Landmeld imagery server: USDA NAIP in the US. To use a national aerial source, add its flag, for example:

  • --swissimage: swisstopo SWISSIMAGE (Switzerland)
  • --pdok: PDOK Luchtfoto (Netherlands); --pdok-layer ortho-hr (8 cm, the default) or ortho-25 (25 cm)
  • --dgt-pt: DGT Ortofotomapas (Portugal)
  • --ign: IGN orthophotography (France)

--imagery-pixel-m sets the imagery pixel size in metres. --xyz-url with --zoom uses any XYZ tile server instead; the URL must contain {z}, {x} and {y}.

To see what the imagery server holds for an area (coverage, resolution, dates) without downloading anything, add --imagery-info.

Map data

--map downloads Overture Maps data into the project: water, land, land_use, buildings or transportation. Repeat the flag or separate datasets with commas. It needs a .land output. --overture-release picks a release; the latest is used when you leave it out.

Mesh and texture

OptionDefaultMeaning
--mesh-spacing-m30Largest distance between mesh vertices, in metres.
--height-samplingbilinearbilinear, or bicubic for smooth slopes without creases along the DEM grid.
--texel-mabout 0.29Metres per texture pixel. The area is cut into tiles whose textures are at most 1024 px.

Other options

  • --force: replace an existing output file.
  • --quiet: no progress output; errors are still printed.
  • --threads: CPU threads; 0 (the default) uses all of them.
  • --max-memory-mib: working memory budget, 1024 MiB by default.