Changes

no edit summary
Line 1: Line 1: −
<pre style="background-color: #EEEEEE; color: Black; border-radius: 10px; padding: 10px;">
+
<pre class="header-style">
This trigger will fire when it detects that a particular cell tower or group of cell towers is in/out of range.</pre>
+
This trigger will fire when it detects that a particular cell tower or group of cell towers is in/out of range. This is a low-accuracy location method useful for identifying presence in a general area such as a town or city, as cell tower coverage typically spans many kilometers.
<br>
+
</pre>
'''Example Usage'''<br/>
     −
<pre style="background-color: #AC2424; color: white; border-radius: 10px; padding: 10px;">
+
''' Options '''
Triggers
      +
* '''Enter Cell Area''' - The trigger fires when at least one cell tower from the selected group becomes detectable, confirming you are within the group's coverage zone.
   −
</pre><br>
+
* '''Leave Cell Area''' - The trigger fires when no cell towers from the selected group are detected, confirming you have moved outside the coverage area.
<pre style="background-color: #1665B0; color: white; border-radius: 10px; padding: 10px;">
  −
Actions
      +
After selecting enter/leave, you will be taken to the Cell Tower List screen where you can:
 +
* Create a new cell tower group by scanning visible towers at your current location
 +
* Select an existing cell tower group
   −
</pre><br>
+
''' Cell Tower Groups '''
<pre style="background-color: green; color: white; border-radius: 10px; padding: 10px;">
  −
Constraints
      +
Cell tower groups are collections of cell tower IDs that define a geographic area. To create a group:
 +
1. Go to the location you want to define
 +
2. Add a new cell tower group and scan the visible towers
 +
3. Give the group a meaningful name
   −
</pre><br>
+
The trigger compares currently visible cell towers against the saved group to determine whether you are within or outside the coverage area.
 +
 
 +
''' Examples '''
 +
 
 +
Example 1: Turn on WiFi when arriving at home area
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Cell Tower Change [Enter Cell Area: Home]</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
WiFi On</pre>
 +
 
 +
Example 2: Silent mode when leaving home city
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Cell Tower Change [Leave Cell Area: Home City]</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Set Ringer Mode: Silent</pre>
 +
 
 +
''' Notes '''
 +
 
 +
* Cell tower-based location is less accurate than GPS but uses significantly less battery power.
 +
* The trigger polls cell tower information at regular intervals. You can configure the update rate in MacroDroid Settings.
 +
* Setting the update interval to 0 uses a 30-second interval.
 +
* The trigger listens for real-time cell location changes when the device is awake.
 +
* On Android 8.1+, location services must be enabled for this trigger to work.
 +
* The trigger requires the SCHEDULE_EXACT_ALARM permission on Android 12+ for reliable timing.
 +
 
 +
''' Permissions Required '''
 +
 
 +
* ACCESS_FINE_LOCATION
 +
* ACCESS_COARSE_LOCATION
 +
* READ_PHONE_STATE
 +
 
 +
''' See Also '''
 +
 
 +
* [[Constraint:_Cell_Towers|Cell Tower Constraint]]
 +
* [[Trigger:_Geofence_Trigger|Geofence Trigger]]
 +
* [[Trigger:_Location_Trigger|Location Trigger]]