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
| Option | Meaning |
|---|---|
--center-lon, --center-lat | The area’s centre, in WGS84 degrees. |
--width-m | Width in metres. |
--height-m | Height in metres; the width when not given. |
--rotation-deg | Clockwise 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) orortho-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
| Option | Default | Meaning |
|---|---|---|
--mesh-spacing-m | 30 | Largest distance between mesh vertices, in metres. |
--height-sampling | bilinear | bilinear, or bicubic for smooth slopes without creases along the DEM grid. |
--texel-m | about 0.29 | Metres 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.