Skip to content

g.download.location

Download GRASS Location from the web

Get GRASS Location from an URL or file path

g.download.location url=string [name=name] [path=path] [dbase=string] [--verbose] [--quiet] [--qq] [--ui]

Example:

g.download.location url=string

grass.script.run_command("g.download.location", url, name=None, path=None, dbase=None, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("g.download.location", url="string")

Parameters

url=string [required]
    URL of the archive with a location to be downloaded
    URL of ZIP, TAR.GZ, or other similar archive
name=name
    Project (location) name
    Project name (not path to project)
path=path
    GRASS GIS database directory
    Default: path to the current GRASS GIS database
dbase=string
    Path to database, use path option instead
    This option is obsolete and replaced by path
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

url : str, required
    URL of the archive with a location to be downloaded
    URL of ZIP, TAR.GZ, or other similar archive
name : str, optional
    Project (location) name
    Project name (not path to project)
    Used as: input, location, name
path : str, optional
    GRASS GIS database directory
    Default: path to the current GRASS GIS database
    Used as: input, dbase, path
dbase : str, optional
    Path to database, use path option instead
    This option is obsolete and replaced by path
verbose: bool, optional
    Verbose module output
    Default: False
quiet: bool, optional
    Quiet module output
    Default: False
superquiet: bool, optional
    Very quiet module output
    Default: False

DESCRIPTION

g.download.location downloads an archived (e.g., .zip or .tar.gz) location from a given URL and unpacks it to a specified or current GRASS GIS Spatial Database. URL can be also a local file on the disk. If the archive contains a directory which contains a location, the module will recognize that and use the location automatically. First directory which is a location is used. Other locations or any other files are ignored.

SEE ALSO

g.mapset, g.mapsets, r.proj, v.proj, g.proj.all

AUTHOR

Vaclav Petras, NCSU GeoForAll Lab

SOURCE CODE

Available at: g.download.location source code (history)
Latest change: Thursday Feb 20 13:02:26 2025 in commit 53de819