Geometry

Custom geospatial searches in which you provide the coordinates of the region to search.

--bbox PATH | "XMIN, YMIN, XMAX, YMAX"

A bounding box to search. Usually the path to a supported GIS file, such as a Shapefile or GeoJSON. May also be a comma-delimited, WGS-84 "XMIN, YMIN, XMAX, YMAX" coordinate sequence. If a GIS file, then the bounding box is calculated from the contained geometries.

Examples:

pwfdf |command| --bbox path/to/my/file.shp
pwfdf |command| --bbox "-121, 32, -119, 34"

--point PATH | "LON, LAT"

A geospatial point to search. Either a comma-delimited "LON, LAT" sequence, or the path to a supported GIS file, such as a Shapefile or GeoJSON. If a GIS file, then the point is calculated as the center of the bounding box for the contained geometries.

Examples:

pwfdf |command| --point path/to/my/file.shp
pwfdf |command| --point "-121, 32"

--geometry PATH | GEOJSON

A spatial geometry to search. Usually the path to a file in a supported GIS file, such as a Shapefile or GeoJSON. May also be a valid WGS-84 GeoJSON geometry string, but this syntax is generally not recommended, as it is difficult to use in practice.

In practice, only relatively coarse geometries are supported, as the geometry cannot cause the underlying query URL to exceed 2000 characters. As a rule of thumb, geometries with fewer than 100 coordinate points are expected to usually work.

Examples:

pwfdf |command| --geometry path/to/my/file.shp
pwfdf |command| --geometry "{\"type\":\"Point\",\"coordinates\":[-121, 32]}"

--geometry-relation RELATION

The spatial relationship between a geospatial search and the search results. Options are:

Relation	Description
intersects (default)	Matches assessments that intersect the geometry at any point.
within	Matches assessments that are fully contained within the geometry.
disjoint	Matches assessments that do not intersect the geometry at any point.

Example:

pwfdf |command| --bbox my-file.shp --geometry-relation intersects
pwfdf |command| --point my-file.shp --geometry-relation within
pwfdf |command| --geometry my-file.shp --geometry-relation disjoint