CoreLocation.description
------------------------

Returns the location data in a formatted text string.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [CoreLocation](component_CoreLocation.md) | [2.7](newinversion27.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ✅ Yes |

MBS( "CoreLocation.description" ) ### Parameters

none

### Result

Returns description.

### Description

Returns the location data in a formatted text string.  
  
A string of the form "<<latitude>, <longitude>> +/- <accuracy>m (speed <speed> kph / heading <heading>) @ <date-time>", where <latitude>, <longitude>, <accuracy>, <speed>, and <heading> are formatted floating point numbers and <date-time> is a formatted date string that includes date, time, and time zone information.  
The returned string is intended for display purposes only.  
This function queries current know location. It's updated from time to time. To receive a script call when new location is available, please use [CoreLocation.SetUpdateLocationHandler](CoreLocationSetUpdateLocationHandler.md).  
### Examples

Query description:

 Set Field \[ CoreLocation::description ; MBS ("CoreLocation.description") \]  
### See also

- [CoreLocation.hasLocation](CoreLocationhasLocation.md)
- [CoreLocation.SetUpdateLocationHandler](CoreLocationSetUpdateLocationHandler.md)

### Example Databases

- [Mac and iOS/CoreLocation/CoreLocation](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/CoreLocation/CoreLocation.shtml#2ScriptAnchor_)

This function checks for a license.

Created 18th August 2014 , last changed 2nd December 2025

  
[CoreLocation.course](CoreLocationcourse.md) - [CoreLocation.desiredAccuracy](CoreLocationdesiredAccuracy.md)

[HTML Version](CoreLocationdescription.shtml)