Geo Search
Real-time view on what entities are nearby with respect to geofence radius
Overview
Often when performing real-time geospatial analytics the objective is to gain a view of what entities are nearby such as friends, businesses, local interests, cell towers etc,. This processor provides the ability to perform such a function using a configurable search area and entities that may be of concern.
A geo search is performed against a spatial index using the passed event attributes which will return 0 or more nearby entities.
Example
Response
Attributes schema
Attribute | Description | Data Type | Required |
---|---|---|---|
name | Descriptive name of the processor function | String Default: Random UUID | |
search area | Area to search | Integer Default: 8 | |
response field | Custom field name to place result of search lookup | String Default: geoSearchResult | |
latitude field | Custom field name to gain latitude dimension | String Default: latitude | |
longitude field | Custom field name to gain longitude dimension | String Default: longitude | |
convertWGS84ToTileCoords | Flag to convert WGS84 coordinates to tile coordinates | Boolean Default: true | |
spatial index | An area is set out as a search tree. The default area is a flattened world divided out in to rectangles. | ||
spatial entities | Spatial entities to return on a successful search | See Spatial Entities section |
Spatial Entities
These are entities that have the required location attributes that enable the search algorithm to be executed against. Since entities are specific to the use case and business domain and/or industry the ability to leverage these assets within Joule a parser API is provided. The parser translates existing entity structures, via a file, in to a support Joule data structure.
Parser example
This example parses a cell tower file using the Apache Arrow library. CellTower extends the GeoNode class to simplify the implementation.
Attributes schema
Attribute | Description | Data Type | Required |
---|---|---|---|
parser | Custom parser that converts to a custom type that extends GeoNode, see documentation for further details on implementing a GeoNode entity | String | |
source | Source of the file | String |
Last updated