Table of Contents

Search

  1. Preface
  2. RulePoint
  3. RulePoint Concepts
  4. Using RulePoint
  5. RulePoint Objects
  6. Working with Topics
  7. Working with Connections
  8. Working with Sources
  9. Working with Responders
  10. Working with Responses
  11. Working with Watchlists
  12. Working with Analytics
  13. DRQL
  14. Working with Rules
  15. Working with Alerts
  16. Setting Access Controls
  17. Troubleshooting RulePoint Issues
  18. Connecting to an Ultra Messaging Application
  19. Creating an Ultra Messaging JMS Source

User Guide

User Guide

geoinbound

geoinbound

The geoinbound analytic checks if a line has its points starting outside a polygon and ending inside the polygon. The first four arguments refer to the points of the line. The remaining arguments refer the points of the polygon.
The polygon can have the following coordinates:
  • n
    number of latitude and longitude pairs. For example, it can be polyLat1, polyLong1, polyLat2, polyLong2, ..., ..., polyLatN, polyLongN . The number of latitude arguments must be equal to the number of longitude arguments. Specify the values directly in the analytic or it can be accessed as an event property.
  • Access list of latitudes and a list of longitudes from watchlists whose type is list. Both latitude and longitudes coordinate lists must be the same size, and each coordinate in either list must correspond to the coordinate in the same position in the other list. For example, geoinbound ( l.lat1,l.long1,l.lat2,l.long2, Watchlist:lats, Watchlist:longs ). In this case, Watchlist:lats and Watchlist:longs are watchlists of type list.
  • Access a single two-dimensional list of comma-separated latitudes and longitudes as arguments from watchlists whose type is text . For example, geoinbound ( l.lat1,l.long1,l.lat2,l.long2, Watchlist:polgygon ). In this case, Watchlist:polgygon is of type text.
The following criteria defines how you can create a polygon:
  • The polygon must have at least three sides.
  • Polygons are always two-dimensional, horizontal shapes.
  • All polygons must be closed. If you do not close the polygon in the analytic, the analytic automatically closes the polygon by connecting the last specified point to the first point. To close the polygon in the analytic, set the arguments for the last polygon point to be the same as those of the first polygon point.
  • Calculate all lines between polygon points as straight.
  • Polygon lines can be crossed to create multiple inside areas.
  • The order of the arguments in the analytic define the order in which the points of the polygon connect. For example, if you define the points as A, D, C, B, the polygon is constructed from point A to D, D to C, and C to B.
  • Coordinate literal arguments must be strings placed within quotation marks.

Syntax

geoinbound(l.lat1,l.long1,l.lat2,l.long2, polyLat1, polyLong1, polyLat2, polyLong2, polyLat3, polyLong3 ,[polyLat4],[ polyLong4],..)
The following table describes the required and optional arguments:
Argument
Required
Optional
Description
l.lat1,l.long1,l.lat2,l.long2
Required
The four geo points which form the line.
polyLat1, polyLong1, polyLat2, polyLong2, polyLat3, polyLong3
Required
The minimum points that form a polygon. The number of latitude arguments must be equal to the number of longitude arguments.
[polyLat4],[polyLong4],...
Optional
The other points that form the polygon.
The following table provides the datatype for the parameters you can pass:
Parameter Input Options
Datatype
Event property
Real number
Watchlist values
Real number
Example
when 1 line l with geoinbound(l.lat1,l.long1,l.lat2,l.long2,100,100,100,-100,-100,-100,-100,100) as result then response with body= “${result}”
The following table describes the result for the event property value that you pass:
Event Property Value
Description
Result
l.lat1 =150
l.long1=150
l.lat2=0
l.long2=0
Verify that the line has its points starting outside a geo polygon and ending inside the geo polygon.
true

0 COMMENTS

We’d like to hear from you!