Your company here — click to reach over 10,000 unique daily visitors

v.what.1grass - Man Page

Queries a vector map at given locations.


vector, querying, position


v.what --help
v.what [-dagjm] map=name[,name,...]  [layer=string[,string,...]]   [type=string[,string,...]]  coordinates=east,north  [distance=float]   [columns=name[,name,...]]   [--help]  [--verbose]  [--quiet]  [--ui]



Print topological information (debugging)


Print attribute information


Print the stats in shell script style


Print the stats in JSON


Print multiple features if overlapping features are found


Print usage summary


Verbose module output


Quiet module output


Force launching GUI dialog


map=name[,name,...] [required]

Name of vector map(s)


Layer number or name (’-1’ for all layers)
A single vector map can be connected to multiple database tables. This number determines which table to use. When used with direct OGR access this is the layer name.
Default: -1


Input feature type
Options: point, line, boundary, centroid, area, face, kernel
Default: point,line,area,face

coordinates=east,north [required]

Coordinates for query
’-’ for standard input


Query threshold distance
Default: 0


Name of attribute column(s)
Default: all columns


v.what outputs the category number value(s) associated with user-specified location(s) in user-specified vector map layer(s). This module was derived from the d.what.vect module by removing all interactive code and modification of the output for easy parsing. Using the -g flag generates script-style output which is easily parsable.


North Carolina sample dataset example:

Query polygon at given position:

v.what zipcodes_wake coordinates=637502.25,221744.25

Find closest hospital to given position within given distance (search radius):

v.what hospitals coordinates=542690.4,204802.7 distance=2000000

See Also

d.what.rast, d.what.vect, v.rast.stats, v.vect.stats, v.what.rast, v.what.rast3, v.what.vect


Trevor Wiens
Edmonton, Alberta, Canada

Source Code

Available at: v.what source code (history)

Accessed: Tuesday May 14 13:41:31 2024

Main index | Vector index | Topics index | Keywords index | Graphical index | Full index

© 2003-2024 GRASS Development Team, GRASS GIS 8.3.2 Reference Manual


GRASS 8.3.2 GRASS GIS User's Manual