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

	<syntax>
		<example>headingChanged <i>heading</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Sent to the current card of the defaultStack when the heading of the device changes.</summary>

	<examples>
<example><p>on headingChanged theHeading</p><p>   updateMapPosition theHeading -- <i>update the marker on the map showing the current heading</i></p><p>end headingChanged</p></example>
	</examples>

	<history>
		<introduced version="4.6.1">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="5.5">Updated parameters</changed>
	</history>

	<objects>
	</objects>

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

	<classes>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
	</classification>

	<references>
		<function tag="mobileCanTrackLocation">mobileCanTrackLocation Function</function>
		<function tag="mobileCanTrackHeading">mobileCanTrackHeading Function</function>
		<function tag="mobileCurrentHeading">mobileCurrentHeading Function</function>
		<function tag="iphoneHeadingCalibrationTimeout">iphoneHeadingCalibrationTimeout Function</function>
		<command tag="iphoneSetHeadingCalibrationTimeout">iphoneSetHeadingCalibrationTimeout Command</command>
		<message tag="trackingError">trackingError Message</message>
	</references>

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

		<parameters>
  <parameter>
    <name>heading</name>
    <description>the heading of the device, in degrees relative to true north if available, otherwise relative to magnetic north </description>
  </parameter>		</parameters>

	<value></value>
	<comments>The <b>headingChanged</b> message is sent to the current card of the defaultStack when the heading of the device changes. <p></p><p>If heading tracking cannot be started (typically due to a lack of calibration) then a trackingError message is sent instead.</p></comments>
	</description>
</doc>