Jump to content

Geofence: Difference between revisions

From Transight Wiki
← Older editNewer edit →
No edit summary
No edit summary
Line 1: Line 1:
== Introduction ==
== Introduction ==
Geofencing is a key feature in GPS tracking. It allows users to define virtual boundaries on a map. When a vehicle or asset enters or exits these boundaries, the system can trigger alerts or actions.
Geofencing is a core feature in modern GPS tracking systems. It allows users to define virtual boundaries on a map. When a GPS-tracked vehicle or asset enters or exits these areas, the system automatically triggers alerts or actions.
 
== How Geofence Works ==
== How Geofence Works ==
* A geofence can be circular or polygonal.
* A geofence can be a circular or polygonal area defined by latitude and longitude.
* The GPS tracker regularly checks its position via satellites.
* The Discovery 4G GPS tracker continuously checks its current location via satellite.
* The system compares the location against the defined geofence.
* The system compares this live data against the predefined geofence area.
* When the boundary is crossed, it logs or notifies the event.
* If the asset enters or exits, the event is logged or notified based on configuration.


== Getting Coordinates from Google Maps ==
== How to Get Coordinates from Google Maps ==
# Open [https://maps.google.com Google Maps].
# Open [https://maps.google.com Google Maps]
# Search for your location (e.g., office, school).
# Search for your desired location (e.g., warehouse, school)
# Right-click the spot and select '''"What’s here?"'''
# Right-click on the location and select '''“What’s here?”'''
# Copy the decimal coordinates shown (e.g., 10.0556255, 76.3544891).
# Note the coordinates shown below (e.g., '''10.0556255, 76.3544891''')
# Use these as:
## Center point for circular geofences
## Corner points for polygon geofences (at least 3, ideally 4–6)
# Enter the values into the command format explained below


Use these coordinates:
'''Note''': A maximum of '''6 geofences''' (circle or polygon combined) can be configured on any Transight telematics device.
* As the center for circular geofences.
* As corners for polygon geofences (3–6 recommended points).


== Geofence Command Format ==
== Geofence Command Format ==
* '''Status''': 1 = Enable, 0 = Disable
* '''Status''': 1 = Enable, 0 = Disable
* '''Geofence ID''': Unique number (e.g., 1313)
* '''Geofence ID''': Unique ID (e.g., 1313, 1777)
* '''Alert Type''': 1 = Entry, 2 = Exit, 3 = Both
* '''Alert Type''': 1 = Entry, 2 = Exit, 3 = Both
* '''Shape''': 0 = Circle, 1 = Polygon
* '''Shape''': 0 = Circle, 1 = Polygon
* '''Latitude/Longitude''': Decimal format
* '''Latitude/Longitude''': Decimal format (e.g., 10.0556255, 76.3544891)
* '''Radius''': In meters (only for circular type)
* '''Radius''': Only for circles (in meters)
* '''#''': Parameter separator
* '''#''': Used to separate parameters
* '''&''': Required at end of polygon commands
* '''&''': Must be added at the end of polygon commands
 
== Command Examples with Field Mapping ==
 
=== Example 1: Circular Geofence ===
'''Objective''': Create a 1000-meter circular geofence at '''10.0556255, 76.3544891'''
 
* Status: 1 
* Geofence ID: 1313 
* Alert Type: 3 
* Shape: 0 
* Latitude: 10.0556255 
* Longitude: 76.3544891 
* Radius: 1000 


== Circular Geofence Example ==
'''Command format:'''
Objective: Create a 1000-meter circular geofence at 10.0556255, 76.3544891
<pre>
SET CUGF:&lt;Status&gt;&lt;Geofence ID&gt;-&lt;Alert Type&gt;-&lt;Shape&gt;#&lt;Latitude-Longitude&gt;#&lt;Radius&gt;
</pre>


'''Example:'''
<pre>
<pre>
SET CUGF:1-1313-3-0#10.0556255-76.3544891#1000
SET CUGF:1-1313-3-0#10.0556255-76.3544891#1000
</pre>
</pre>


Response:
'''Response:'''
<pre>
<pre>
IMEI: 862942074896044
IMEI: 862942074896044
Command: SET CUGF:1-1313-3-0#10.0556255-76.3544891#1000
Command: SET CUGF:1-1313-3-0#10.0556255-76.3544891#1000
Response: Error : 0
Response:
Error : 0
</pre>
</pre>


== Polygon Geofence Example ==
=== Example 2: Polygon Geofence ===
Objective: Create a polygon geofence with 4 corner points.
'''Objective''': Create a polygon geofence with 4 corner points (first point repeated at the end)
 
* Status: 1 
* Geofence ID: 1777 
* Alert Type: 3 
* Shape: 1 
* Coordinates:
** 10.0535097, 76.334262 
** 10.0504267, 76.3328855 
** 10.0474386, 76.3439598 
** 10.0503084, 76.3437023 
** 10.0535097, 76.334262 (repeat to close loop) 


Coordinates:
'''Command format:'''
* 10.0535097, 76.334262
<pre>
* 10.0504267, 76.3328855
SET CUGF:&lt;Status&gt;&lt;Geofence ID&gt;-&lt;Alert Type&gt;-&lt;Shape&gt;#&lt;Lat-Long&gt;#...#&lt;Lat-Long&gt;&amp;
* 10.0474386, 76.3439598
</pre>
* 10.0503084, 76.3437023
* (Repeat the first point to close the shape)


Command:
'''Example:'''
<pre>
<pre>
SET CUGF:1-1777-3-1#10.0535097-76.334262#10.0504267-76.3328855#10.0474386-76.3439598#10.0503084-76.3437023#10.0535097-76.334262&
SET CUGF:1-1777-3-1#10.0535097-76.334262#10.0504267-76.3328855#10.0474386-76.3439598#10.0503084-76.3437023#10.0535097-76.334262&amp;
</pre>
</pre>


== Save the Configuration ==
'''Response:'''
After setting geofences, save to memory:
<pre>
IMEI: 862942074896044
Command: SET CUGF:1-1777-3-1#...
Response:
Error : 0
</pre>


== Save Configuration ==
After setting up geofences, you must execute the below command to save the configuration permanently:
<pre>
<pre>
SET TSMR:2
SET TSMR:2
</pre>
</pre>


== Check Configured Geofences ==
== To Check Configured Geofences ==
To view saved geofences:
Use the command:
 
<pre>
<pre>
GET CUGF
GET CUGF
</pre>
</pre>
This will show all geofences currently saved in the device memory.


== Final Checklist ==
==Final Verification ==
* Confirm GPS fix is available on device.
After setup:
* Move the vehicle inside and outside geofence area.
* Ensure the device has a GPS fix
* Verify alerts or logs are triggered correctly.
* Drive or move the asset in and out of the geofenced area
* Confirm alerts are received/logged as expected

Revision as of 05:44, 28 June 2025

Introduction

Geofencing is a core feature in modern GPS tracking systems. It allows users to define virtual boundaries on a map. When a GPS-tracked vehicle or asset enters or exits these areas, the system automatically triggers alerts or actions.

How Geofence Works

  • A geofence can be a circular or polygonal area defined by latitude and longitude.
  • The Discovery 4G GPS tracker continuously checks its current location via satellite.
  • The system compares this live data against the predefined geofence area.
  • If the asset enters or exits, the event is logged or notified based on configuration.

How to Get Coordinates from Google Maps

  1. Open Google Maps
  2. Search for your desired location (e.g., warehouse, school)
  3. Right-click on the location and select “What’s here?”
  4. Note the coordinates shown below (e.g., 10.0556255, 76.3544891)
  5. Use these as:
    1. Center point for circular geofences
    2. Corner points for polygon geofences (at least 3, ideally 4–6)
  6. Enter the values into the command format explained below

Note: A maximum of 6 geofences (circle or polygon combined) can be configured on any Transight telematics device.

Geofence Command Format

  • Status: 1 = Enable, 0 = Disable
  • Geofence ID: Unique ID (e.g., 1313, 1777)
  • Alert Type: 1 = Entry, 2 = Exit, 3 = Both
  • Shape: 0 = Circle, 1 = Polygon
  • Latitude/Longitude: Decimal format (e.g., 10.0556255, 76.3544891)
  • Radius: Only for circles (in meters)
  • #: Used to separate parameters
  • &: Must be added at the end of polygon commands

Command Examples with Field Mapping

Example 1: Circular Geofence

Objective: Create a 1000-meter circular geofence at 10.0556255, 76.3544891

  • Status: 1
  • Geofence ID: 1313
  • Alert Type: 3
  • Shape: 0
  • Latitude: 10.0556255
  • Longitude: 76.3544891
  • Radius: 1000

Command format: 

SET CUGF:<Status><Geofence ID>-<Alert Type>-<Shape>#<Latitude-Longitude>#<Radius>

Example: 

SET CUGF:1-1313-3-0#10.0556255-76.3544891#1000

Response: 

IMEI: 862942074896044
Command: SET CUGF:1-1313-3-0#10.0556255-76.3544891#1000
Response:
Error : 0

Example 2: Polygon Geofence

Objective: Create a polygon geofence with 4 corner points (first point repeated at the end)

  • Status: 1
  • Geofence ID: 1777
  • Alert Type: 3
  • Shape: 1
  • Coordinates:
    • 10.0535097, 76.334262
    • 10.0504267, 76.3328855
    • 10.0474386, 76.3439598
    • 10.0503084, 76.3437023
    • 10.0535097, 76.334262 (repeat to close loop)

Command format: 

SET CUGF:<Status><Geofence ID>-<Alert Type>-<Shape>#<Lat-Long>#...#<Lat-Long>&

Example: 

SET CUGF:1-1777-3-1#10.0535097-76.334262#10.0504267-76.3328855#10.0474386-76.3439598#10.0503084-76.3437023#10.0535097-76.334262&

Response: 

IMEI: 862942074896044
Command: SET CUGF:1-1777-3-1#...
Response:
Error : 0

Save Configuration

After setting up geofences, you must execute the below command to save the configuration permanently: 

SET TSMR:2

To Check Configured Geofences

Use the command: 

GET CUGF

This will show all geofences currently saved in the device memory.

Final Verification

After setup:

  • Ensure the device has a GPS fix
  • Drive or move the asset in and out of the geofenced area
  • Confirm alerts are received/logged as expected
Retrieved from "https://telematics.transight.com/index.php?title=Geofence&oldid=570"