<doc>
	<legacy_id></legacy_id>
	<name>locationChanged</name>
	<type>message</type>

	<syntax>
		<example>locationChanged<i> latitude, longitude, altitude</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Sent to the current card of the default stack when the location of the device changes.</summary>

	<examples>
<example><p>on locationChanged pLatitude, pLongitude, pAltitude</p><p>   put pAltitude into field &quot;altitude&quot;</p><p>end locationChanged</p></example>
<example><p>on locationChanged</p><p>   put mobileCurrentLocation() into theLocation</p><p>   updateMapPosition theLocation -- <i>update the marker on the map showing the current location</i></p><p>end locationChanged</p></example>
	</examples>

	<history>
		<introduced version="4.5.2">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="5.5">Parameters updated, Android support</changed>
	</history>

	<objects>
	</objects>

	<platforms>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
	</classification>

	<references>
		<function tag="mobileCurrentLocation">mobileCurrentLocation Function</function>
		<command tag="mobileStartTrackingSensor">mobileStartTrackingSensor Command</command>
		<command tag="mobileStopTrackingSensor">mobileStopTrackingSensor Command</command>
		<message tag="trackingError">trackingError message</message>
	</references>

	<description>
	<overview>Handle the <b>locationChanged</b> message if you want to perform tasks when the location of the device changes.</overview>

		<parameters>
  <parameter>
    <name>latitude</name>
    <description>the latitude of the device</description>
  </parameter>
  <parameter>
    <name>longitude</name>
    <description>the longitude of the device</description>
  </parameter>
  <parameter>
    <name>altitude</name>
    <description>the altitude of the device</description>
  </parameter>		</parameters>

	<value></value>
	<comments>The <b>locationChanged</b> message is sent to the current card of the default stack when the location of the device changes. <p></p><p>If location tracking cannot be started (typically due to the user &apos;not allowing&apos; access to CoreLocation) then a trackingError message is sent instead.</p></comments>
	</description>
</doc>