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