Vespucci supports a large subset of JOSM search expressions, these can be used for locating and selecting specific objects in the in memory data, and for matching elements against roles in preset member_expression attributes.
As there is essentially no documentation available from JOSM there is no guarantee that the behaviour is the same in all cases, known and deliberate differences are noted below. A reformatted and expanded version of what is available from JOSM is available here JOSM filter documentation.
Overpass API queries#
We support generating Overpass queries from the JOSM search language very similar to how JOSM and Overpass Turbo does the same. The most important deviation is that in and around expressions are treated like normal predicates. In the case of boolean logical "and" combinations this doesn't make a difference
highway=residential type:way in Bergdietikon
will work as expected. However
highway=residential | highway=unclassified in Bergdietikon
will not. To get "normal" behaviour add brackets
(highway=residential | highway=unclassified) in Bergdietikon
Note that we do not automatically restrict the query extent to the current visible extent of the map, you need to explicitly add an inview predicate to do that.
will try to retrieve residential streets for the whole world. However
highway=residential type:way inview
will restrict the query to the current map view.
|Syntax||Overpass||Vespucci specific notes|
|✅||key>reference||Compares the value associated with key to reference, if possible if will convert to numeric values first|
|✅||expr AND expr||✅|
|✅||expr | expr||✅|
|✅||expr OR expr||✅|
|✅||expr XOR expr||✅|
|✅||preset:"__preset item path"__||Vespucci uses "|" as preset path segment separator and only fixed tags are considered for matching|
|✅||preset:"__preset group path/*"__||The asterix is ignored, the relevant criteria is if the path references a preset group|
|user:||✅||Vespucci currently doesn't store this information|
|changeset:||Vespucci currently doesn't store this information|
|✅||nodes:range||All nodes are counted, for closed ways that implies that start and end node are counted separately|
|✅||incomplete||Only used for relations|