druid/geo.md at ce3c0dae4d5a0fa78dd6e081d879240898ef6dcb

mirror of https://github.com/apache/druid.git synced 2025-02-06 18:18:17 +00:00

Docusaurus build framework + ingestion doc refresh. (#8311 )

* Docusaurus build framework + ingestion doc refresh.

* stick to npm instead of yarn

* fix typos

* restore some _bin

* Adjustments.

* detect and fix redirect anchors

* update anchor lint

* Web-console: remove specific column filters (#8343)

* add clear filter

* update tool kit

* remove usless check

* auto run

* add %

* Fix resource leak (#8337)

* Fix resource leak

* Patch comments

* Enable Spotbugs NP_NONNULL_RETURN_VIOLATION (#8234)

* Fixes from PR review.

* Fix more anchors.

* Preamble nix.

* Fix more anchors, headers

* clean up placeholder page

* add to website lint to travis config

* better broken link checking

* travis fix

* Fixed more broken links

* better redirects

* unfancy catch

* fix LGTM error

* link fixes

* fix md issues

* Addl fixes

2019-08-20 21:48:59 -07:00

2.8 KiB

Raw Blame History

id	title
geo	Spatial filters

Apache Druid (incubating) supports filtering specially spatially indexed columns based on an origin and a bound.

Spatial indexing

In any of the data specs, there is the option of providing spatial dimensions. For example, for a JSON data spec, spatial dimensions can be specified as follows:

{
	"type": "hadoop",
	"dataSchema": {
		"dataSource": "DatasourceName",
		"parser": {
			"type": "string",
			"parseSpec": {
				"format": "json",
				"timestampSpec": {
					"column": "timestamp",
					"format": "auto"
				},
				"dimensionsSpec": {
					"dimensions": [],
					"spatialDimensions": [{
						"dimName": "coordinates",
						"dims": ["lat", "long"]
					}]
				}
			}
		}
	}
}

Spatial filters

property	description	required?
dimName	The name of the spatial dimension. A spatial dimension may be constructed from multiple other dimensions or it may already exist as part of an event. If a spatial dimension already exists, it must be an array of coordinate values.	yes
dims	A list of dimension names that comprise a spatial dimension.	no

The grammar for a spatial filter is as follows:

"filter" : {
    "type": "spatial",
    "dimension": "spatialDim",
    "bound": {
        "type": "rectangular",
        "minCoords": [10.0, 20.0],
        "maxCoords": [30.0, 40.0]
    }
}

Bound types

`rectangular`

property	description	required?
minCoords	List of minimum dimension coordinates for coordinates [x, y, z, …]	yes
maxCoords	List of maximum dimension coordinates for coordinates [x, y, z, …]	yes

`radius`

property	description	required?
coords	Origin coordinates in the form [x, y, z, …]	yes
radius	The float radius value	yes

`polygon`

property	description	required?
abscissa	Horizontal coordinate for corners of the polygon	yes
ordinate	Vertical coordinate for corners of the polygon	yes

2.8 KiB Raw Blame History