====== Locator control ======
Use GPS and/or network to find location

===== Description =====
Create a Locator object using the **CreateLocator** function of the **[[built_in:app|app]]** object:
<code>sns = app.CreateLocator( provider );</code>
Location providers available are: 
  * **"GPS"**
  * **"Network"**
  * **"GPS,Network"**

You can use the **SetOnChange** function of the Locator to set the name of a function you want to be called when a the changes occur.

Change the rate that a Locator checks for changes with the **SetRate** method.
===== Methods =====
^Method ^Description ^
|Locator.GetBearingTo() |Returns the approximate initial bearing in degrees East of true North when traveling along the shortest path between this location and the given location. |
|Locator.GetDistanceTo() |Returns the approximate distance in meters between this location and the given location. |
|Locator.SetOnChange(callback) | |
|Locator.SetRate(seconds) |Set Locator update frequency in seconds |
|Locator.Start() | |
|Locator.Stop() | |