GeoRadialSearch Command |
|
Use the GeoRadialSearch command in a Logic Template to search a geo-spatial index for records containing coordinates that lie within any of the geo-spatial grid rectangles that are touched by the circular area being searched. To obtain exact results, the records returned by the search request should then be filtered by the GeoCircleFilter command.
To execute a Search Geo-Spatial Index Radial request, use the GeoRadialSearch command with seven arguments:
GeoRadialSearch( fc, idx, cntr, rad, pas, wt, unts );
GeoRadialSearch Arguments
Argument |
Description |
fc |
The function code defining how to merge results.( NONRESTRICTIVE, RESTRICTIVE ) |
idx |
The geo-spatial index to be searched. |
cntr |
The name of the HTML variable containing the coordinates of the center of the circle. |
rad |
The name of the HTML variable containing the radius of the circle. |
pas |
The pass during which the search is to be executed. |
wt |
The weighting value to apply to this search. The weighting value may be passed directly or within an HTML variable. |
unts |
Determines the units to be used ( MILES or KILOMETERS ) for the radius rad. |
Access the GeoRadialSearch Dialog Box by selecting the Geo-Spatial Index->Radial menu item under the Searching category of the Logic Template editor command menu.
Examples
Command |
Description |
GeoRadialSearch( NONRESTRICTIVE, AreaIndex, Center, Radius, 1, 4, MILES); |
Search geo-spatial index named "AreaIndex" during pass 1 with a weighting value of 4. Use the coordinates stored in the HTML variable "Center" as the center and the value stored in HTML variable "Radius" as the radius with the units in miles, and OR the results with other indexes. |
Center = { -82.232, 29.233 }; Radius = 25; GeoRadialSearch( RESTRICTIVE, AreaIndex, Center, Radius, 3, 0, KILOS); |
Search geo-spatial index named "AreaIndex" during pass 3 without a weighting value. Use coordinates -82.232° and 29.233° as the center and the value 25 kilometers as the radius and AND the results with other indexes. |
IF ( Radius && Center ) GeoRadialSearch( NONRESTRICTIVE, AreaIndex, Center, Radius, 1, Weight, MILES ); ENDIF |
If the HTML variable "Radius" contains something other than zero and the HTML variable "Center" contains a pair of coordinates, search the geo-spatial index named "AreaIndex" during pass 1 for the circle defined by the HTML variables "Center" and "Radius" and OR the results to other indexes using a weighting value stored in the HTML variable "Weight". |