949        </item>

   950        <item

   951              description="This function can be used as a callback in GetLocation and Trace calls to location service."

   952              id="org.symbian.tools.wrttools.location"

   953              label="Location callback">

   954           <content>

   955 function locationUpdated(transactionId, code, result) {

   956 	if (result.ErrorCode == 0) {

   957 		var longitude = result.ReturnValue.Longitude; // Longitude estimate in degrees. The value range is [+180, -180].

   958 		var latitude = result.ReturnValue.Latitude; // Latitude estimate in degrees. The value range is [+90, -90].

   959 		var altitude = result.ReturnValue.Altitude; // Elevation estimate in meters relative to the WGS 84 datum.

   960 		var satelliteNumView = result.ReturnValue.SatelliteNumView; // Number of satellites currently in view.

   961 		var satelliteNumViewUsed = result.ReturnValue.SatelliteNumViewUsed; // Number of satellites used to obtain the location fix.

   962 		var horizontalSpeed = result.ReturnValue.HorizontalSpeed; // Horizontal speed estimate in meters per second. This is the speed of the device at the time the location fix was obtained.

   963 		var horizontalSpeedError = result.ReturnValue.HorizontalSpeedError; // Horizontal speed error in meters per second.

   964 		var trueCourse = result.ReturnValue.TrueCourse; // Current direction of movement in degrees in relation to true north.

   965 		var trueCourseError = result.ReturnValue.TrueCourseError; // TrueCourse error in degrees.

   966 		var magneticHeading = result.ReturnValue.MagneticHeading; // Current direction of movement in degrees in relation to magnetic north.

   967 		var magneticHeadingError = result.ReturnValue.MagneticHeadingError; // MagneticHeading error in degrees.

   968 		var heading = result.ReturnValue.Heading; // Current instantaneous direction of movement in degrees in relation to true north.

   969 		var headingError = result.ReturnValue.HeadingError; // Heading error in degrees.

   970 		var magneticCourse = result.ReturnValue.MagneticCourse; // Current instantaneous direction of movement in degrees in relation to magnetic north.

   971 		var magneticCourseError = result.ReturnValue.MagneticCourseError; // MagneticCourse error in degrees

   972 		// TODO Location information was received

   973 	} else {

   974 		var errorCode = result.ErrorCode;

   975 		var errorMessage = result.ErrorMessage;

   976 		// TODO Failed to retrieve location information

   977 	}

   978 }          </content>

  1005     <category

  1006           description="Snippets using PhoneGap APIs"

  1007           id="org.symbian.tools.wrttools.phonegapsnippets"

  1008           label="PhoneGap"

  1009           smallicon="icons/phonegap.png">

  1010        <item

  1011              description="Accepts accerelometer data"

  1012              id="org.symbian.tools.wrttools.phonegap.accererometer"

  1013              label="Accelerometer callback">

  1014           <content>

  1015 function updateAcceleration(accel) {

  1016 	var x = accel.x;

  1017 	var y = accel.y;

  1018 	var z = accel.z;

  1019 	

  1020 	// TODO process the data

  1021 }

  1022           </content>

  1023        </item>

  1024        <item

  1025              description="Accepts contacts data"

  1026              id="org.symbian.tools.wrttools.phonegap.contacts"

  1027              label="Contacts callback">

  1028           <content>

  1029 function displayContacts(contacts) {

  1030 	for (var i=0; i < contacts.length; i++) {

  1031 		var contact = contacts[i];

  1032 		var name = contact.name.formatted;

  1033 		var phones = contact.name.phone; // Array of phone numbers

  1034 		var name = contact.name.address;

  1035 		

  1036 		// TODO Insert your code here

  1037 	}

  1038 }

  1039           </content>

  1040        </item>

  1041        <item

  1042              description="Accepts location data"

  1043              id="org.symbian.tools.wrttools.phonegap.location"

  1044              label="Location callback">

  1045           <content>

  1046 function updateLocation(position) {

  1047 	var pt = position.coords;

  1048 	var latitude = pt.latitude;

  1049 	var longitude = pt.longitude;

  1050 	var altitude = pt.altitude;

  1051 	var heading = pt.heading;

  1052 	var speed = pt.speed;

  1053 

  1054 	// TODO Insert your code here

  1055 }

  1056           </content>

  1057        </item>

  1058        <item

  1059              description="Accepts orientation data"

  1060              id="org.symbian.tools.wrttools.phonegap.orientation"

  1061              label="Orientation callback">

  1062           <content>

  1063 function updateOrientation(orientation) {

  1064 	switch (orientation) {

  1065 		case DisplayOrientation.PORTRAIT: break;

  1066 		case DisplayOrientation.REVERSE_PORTRAIT: break;

  1067 		case DisplayOrientation.LANDSCAPE_LEFT_UP: break;

  1068 		case DisplayOrientation.LANDSCAPE_RIGHT_UP: break;

  1069 		case DisplayOrientation.FACE_UP: break;

  1070 		case DisplayOrientation.FACE_DOWN: break;

  1071 	}

  1072 

  1073 	// TODO Insert your code here

  1074 }

  1075           </content>

  1076        </item>

  1077     </category>