Novatel MT 3060 R, Command Reference Manual, Page: 218 / 330

- 206 -
AT$PLYFN# Geo Fencing A Polygonal Area
AT$PLYFN# Geo Fencing a Polygonal Area
Command Function
This command allows a user to define up to 25 separate polygonal geographical
areas (# can be any number from 0 to 24). The event engine (see AT$EVENT) can
be set up to send a message when the device moves in or out of the geographical
area defined by the polygon.
Each command defines one of 26 possible vertices or corners. The line segments
of the polygon are generated by connecting the non-zero vertices in sequence (for
example, point 0 is connected to point 1, which is connected to point 2, etc.). The
polygon can be generated in either a clockwise or counterclockwise sequence
(see Notes section below for additional details). You can specify your polygon with
less than 26 vertices, but the first and last points of the polygon still must be
identical
The query returns all non-zero locations defined for the polygon as well as all (0,0)
vertex locations that serve as a polygon terminator.
Syntax Query
AT$PLYFN#=?
Syntax $PLYFN#: (0-25),(-90.0 - +90.0),(-180.0 - +180.0)
OK
Write Syntax
AT$PLYFN#=<idx>,<latitude>,<longitude>
Write Response OK
Read Syntax AT$PLYFN#?
Read Response $PLYFN#: PtIdx Latitude Longitude
<idx> <latitude> <longitude>
OK
Execute Syntax
N/A
Execute Response
N/A
Unsolicited Response
N/A
Parameter Values
<idx> 0-25: index for this vertex of the polygon
<latitude> Defines the latitude for this vertex of the polygon in decimal degrees (for example,
32 degrees 30 minutes 0 seconds would be represented as 32.5 degrees since 30
minutes is exactly 1/2 of a degree). The latitude must be specified in 15 characters