Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.2   6.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4   7.5    Statistic  

UNNotification.SetLocationTrigger

Sets a location trigger.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
UNNotification 7.2 No No No No Yes

MBS( "UNNotification.SetLocationTrigger"; UNNotificationRef; Latitude; Longitude; Radius; Identifier { ; Repeat } )

Parameters

Parameter Description Example value
UNNotificationRef The reference number of the notification. $Notification
Latitude The latitude of the region center. 37.354444
Longitude The longitude of the region center. -121.969167
Radius The radius of the circular region in meter. 50000
Identifier The user displayable identifier for the region. "Santa Clara area"
Repeat Optional
Whether to repeat this notification.
Pass 1 to enable or 0 to disable. Default is 0.
0

Result

Returns OK or error.

Description

Sets a location trigger.
Can be scheduled on the device to notify when the user enters or leaves a geographic region. The identifier on region must be unique. Scheduling multiple notifications with different regions containing the same identifier will result in undefined behavior. The number of location triggers that may be scheduled by an application at any one time is limited by the system. Applications must have "when-in-use" authorization through CoreLocation.

Examples

Create location trigger and query back values:

# Create a new notification
Set Variable [$notification; Value:MBS("UNNotification.New")]
# Set Title and Body
Set Variable [$r; Value:MBS("UNNotification.SetTitle"; $notification; "Hello")]
Set Variable [$r; Value:MBS("UNNotification.SetBody"; $notification; "Greetings from FileMaker")]
# set a location trigger
Set Variable [$r; Value:MBS( "UNNotification.SetLocationTrigger"; $Notification; 37,354444; -121,969167; 50000; "Santa Clara area")]
# and query back trigger settings
Set Variable [$value; Value:MBS("UNNotification.Region"; $notification)]
Set Variable [$value; Value:MBS("UNNotification.Repeats"; $notification)]
# and schedule
Set Variable [$r; Value:MBS("UNNotification.Schedule"; $notification; "test")]

See also


UNNotification.SetLaunchImageName   -   UNNotification.SetScript

Feedback: Report problem or ask question.




Links
MBS Xojo Plugins