Functions Reference

Mobile functions
F
ILEMAKER FUNCTIONS REFERENCE 243
LocationValues
Purpose
Returns the current latitude, longitude, and altitude on an iOS device running FileMaker Go. Returns
the horizontal and vertical accuracy of the values returned and the number of minutes since the
values were returned. The location is obtained via GPS, cellular network, or Wi-Fi.
Format
LocationValues (accuracy {; timeout})
Parameters
accuracy - any numeric expression or field containing a number that represents a distance in
meters.
timeout - any numeric expression or field containing a number that represents the most time it will
take to fetch the location. Measured in seconds, the default value is 60.
Parameters in curly braces { } are optional.
Data type returned
Text
Originated in
FileMaker Pro 12.0
Description
Returns and caches the current location of a device in the format:
latitude¶longitude¶altitude¶horizontal accuracy (+/- accuracy in meters)¶
vertical accuracy (+/- accuracy in meters)¶age of value in minutes (0.2
would represent 0.2 minutes or 12 seconds ago)
You can use the GetValue function to retrieve any of the six carriage return-delimited values above.
LocationValues fetches the location values until the requested accuracy is met or until
timeout
. If you cancel the process, FileMaker Go returns the most accurate location in the cache
(if any). If no location is received, FileMaker
Go returns an empty string.
In FileMaker Pro, LocationValues returns an empty string.
Note To avoid excessive battery consumption and repeat fetches, specify a larger number for
accuracy and a smaller number for timeout.
Examples
LocationValues returns the following location for a device:
37.406489
-121.983428
0.000000
65
-1
0.001236