Reference > Functions reference > Mobile functions > RangeBeacons
 
RangeBeacons
Purpose 
Returns a list of iBeacons and their proximity to an iOS device.
Format 
RangeBeacons (UUID {; timeout; major; minor})
Parameters 
UUID - the universally unique identifier for iBeacons to search for. The UUID identifies one or more iBeacons as a specific type or from a specific organization. For example, iBeacons for all branches of a department store could share the same UUID.
timeout - the number of seconds to wait before returning a value. If timeout is not specified, the function returns a value after five seconds.
major - the value identifying a group of iBeacons. For example, all iBeacons in a specific branch of a department store could share the same major.
minor - the value identifying specific iBeacons within a group of iBeacons. For example, all iBeacons in the toys section of a specific branch of a department store could share the same minor.
Parameters in braces { } are optional.
Data type returned 
Text
Originated in 
FileMaker Pro 15.0
Description 
In FileMaker Go, returns:
UUID - the universally unique identifier for each identified iBeacon.
major - the value identifying a group of iBeacons.
minor - the value identifying specific iBeacons within a group of iBeacons.
proximity - a number indicating the relative proximity to an iBeacon. Returns:
0 (Unknown) The proximity of the iBeacon could not be determined.
1 (Immediate) The iBeacon is very close to the iOS device.
2 (Near) The iBeacon is relatively close to the iOS device.
3 (Far) The iBeacon is far from the iOS device.
accuracy - the accuracy of the proximity value, measured in meters from the iBeacon. This value helps you differentiate between iBeacons with the same proximity value. A negative value means the accuracy could not be determined.
rssi - the received signal strength of the iBeacons, measured in decibels.
Notes
If no iBeacons match the criteria, this function returns an empty string.
If the iOS Location Services setting is turned off, this function returns an empty string.
If the query is not valid, this function returns a question mark (?).
Examples 
RangeBeacons("D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C") returns information about all nearby iBeacons with the specified UUID:
D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C, 10, 1, 0, -1.00, 0
D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C, 5, 1, 3, 14.68, -79
D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C, 5, 2, 3, 18.96, -81
RangeBeacons("D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C"; 30) returns the result after 30 seconds.
RangeBeacons("D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C"; 20; 10; 1) returns information about iBeacons with the specified UUID with a major value of 10 and a minor value of 1. It returns the result after 20 seconds.
Related topics 
Functions reference (category list)
Functions reference (alphabetical list)
About functions
About formulas