RangeBeacons

Returns a list of iBeacons and their proximity to an iOS or iPadOS 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 value.

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 value.

Parameters in braces { } are optional.

Data type returned 

Text

Originated in version 

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 device.
  • 2 (Near) The iBeacon is relatively close to the device.
  • 3 (Far) The iBeacon is far from the 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 Location Services setting is turned off, this function returns an empty string.
  • If the query is not valid, this function returns a question mark (?).

Example 1 

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

Example 2 

RangeBeacons("D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C"; 30) returns the result after 30 seconds.

Example 3 

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