Specify a circular area and subscribe. When the phone enters or leaves, the operator notifies the service provider.
When the phone enters the specified area, the operator sends a notification.
When the phone leaves the specified area, the operator sends a notification.
If the phone is already inside the area when subscribing, you can choose to receive an immediate notification.
A and BEach subscription covers one event type: entry or exit.
Subscription limitsYou can set an expiration time and a maximum number of notifications. A notification is also sent when the subscription ends.
Geofencing Subscriptions: How it works
- Draw the areaThe service provider specifies a circular area (center latitude and longitude, and radius) and the device to monitor.
- Subscribe to an eventChoose an “entry” or “exit” event and provide a URL for notifications.
- Real-time notificationWhen the device enters or leaves the area, the operator sends an event notification to the service provider.
Geofencing Subscriptions: API spec
POST /subscriptions to create; GET/DELETE /subscriptions/{subscriptionId} to retrieve or deleteprotocol (HTTP), sink, types (area-entered or area-left), config.subscriptionDetail (device and circular area)initialEvent immediate report; subscriptionExpireTime, subscriptionMaxEvents| Events | Meaning | Example |
|---|---|---|
| area-entered | Device entered the area | …v0.area-entered |
| area-left | Device left the area | …v0.area-left |
| subscription-ended | Ended | …v0.subscription-ended |
Responses for three scenarios (excerpts)
org.camaraproject.geofencing-subscriptions.v0.area-enteredArea entry eventCIRCLEArea shape specified in the subscriptionorg.camaraproject.geofencing-subscriptions.v0.area-leftArea exit eventCIRCLEArea shape specified in the subscriptiontrueReport the current state immediately when subscribingorg.camaraproject.geofencing-subscriptions.v0.area-enteredArea entry eventSpec source: CAMARA DeviceLocation r3.2 (Geofencing Subscriptions v0.5.0)
Geofencing Subscriptions: GSMA use cases
First Responders
Problem to solveIn disaster zones or hazardous environments, rescuers face delays and risks when assessing damage and finding trapped people.
Geofencing Subscriptions's roleTracks drone locations in real time to coordinate the fleet.
Used together: Quality on Demand, Location Retrieval, Simple Edge Discovery
GSMA source ↗Fleet Management
Problem to solveRemote fleet management is inefficient and carries a risk of unauthorized use.
Geofencing Subscriptions's roleSends a notification when a vehicle leaves its planned area, which may indicate theft or a route deviation.
Used together: Location Retrieval
GSMA source ↗Remote monitoring and control
Problem to solveManaging remote operations is inefficient and carries high risks.
Geofencing Subscriptions's roleSends a notification when an asset leaves its preset area, which may indicate danger.
Used together: Device Swap, Location Retrieval, Quality on Demand
GSMA source ↗Worker Safety Monitoring
Problem to solveMeets workplace safety regulations and prevents delays caused by inadequate on-site safety.
Geofencing Subscriptions's roleSends a notification when workers leave their planned area, as they may be approaching danger.
Used together: Location Retrieval, SMS (sending text messages)
GSMA source ↗Asset Tracking and protection
Problem to solveLost, damaged, or misused assets cause financial losses and operational delays.
Geofencing Subscriptions's roleSends a notification when an asset leaves its preset area, which may indicate theft.
Used together: Device Swap, Location Retrieval
GSMA source ↗Sources: GSMA Open Gateway Use Case Library and API Descriptions (accessed 2026-10-14). Descriptions are summaries.