<!--
{
  "availability" : [
    "iOS: 10.0.0 -",
    "iPadOS: 10.0.0 -",
    "watchOS: 3.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "UserNotifications",
  "identifier" : "/documentation/UserNotifications/UNLocationNotificationTrigger",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "User Notifications"
    ],
    "preciseIdentifier" : "c:objc(cs)UNLocationNotificationTrigger"
  },
  "title" : "UNLocationNotificationTrigger"
}
-->

# UNLocationNotificationTrigger

A trigger condition that causes the system to deliver a notification when the user’s device enters or exits a geographic region you specify.

```
class UNLocationNotificationTrigger
```

## Overview

Create a [`UNLocationNotificationTrigger`](/documentation/UserNotifications/UNLocationNotificationTrigger) object when you want to schedule the delivery of a local notification when the device enters or leaves a specific geographic region. The system limits the number of location-based triggers that it schedules at the same time.

> Important:
> Before scheduling any notifications using this trigger, your app must have authorization to use Core Location and must have when-in-use permissions. (Because the system actually monitors the regions, you don’t need to request always permissions for your app). For information about how to request authorization, see <doc://com.apple.documentation/documentation/CoreLocation/requesting-authorization-to-use-location-services>.

When configuring the region, use the <doc://com.apple.documentation/documentation/CoreLocation/CLRegion/notifyOnEntry> and <doc://com.apple.documentation/documentation/CoreLocation/CLRegion/notifyOnExit> properties to specify whether you want the system to deliver notifications on entry, on exit, or both. Listing 1 shows the creation of a trigger that fires only once when the user’s device enters a circular region with a 2-kilometer radius.

Listing 1. Creating a location-based trigger

```objc
CLLocationCoordinate2D center = CLLocationCoordinate2DMake(37.335400, -122.009201);

CLCircularRegion* region = [[CLCircularRegion alloc] initWithCenter:center
         isn’t  radius:2000.0 identifier:@"Headquarters"];
region.notifyOnEntry = YES;
region.notifyOnExit = NO;

UNLocationNotificationTrigger* trigger = [UNLocationNotificationTrigger
                 triggerWithRegion:region repeats:NO];
```

The system doesn’t immediately trigger region-based notifications when the edge of the boundary is crossed. The system applies heuristics to ensure that the boundary crossing represents a deliberate event and isn’t the result of spurious location data. For more information about the heuristics, see <doc://com.apple.documentation/documentation/CoreLocation/monitoring-the-user-s-proximity-to-geographic-regions>.

## Topics

### Creating a Location Trigger

[`init(region:repeats:)`](/documentation/UserNotifications/UNLocationNotificationTrigger/init(region:repeats:))

Creates a location trigger using the region parameter.

### Accessing the Trigger Region

[`region`](/documentation/UserNotifications/UNLocationNotificationTrigger/region)

The region used to determine when the system sends the notification.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)