trackstart

Starts a new track recording. If the user did not sent the command to stop previous track, this one will be automatically closed and a new one will begin.

Command's fields description:

• txtUser1 field is the “username” of MyWakes account.

• txtUser2 field is the “password” of MyWakes account.

• txtCommand field contains the command: “trackstart”.

• txtFormat optional field specifies txtParameters and response formats. more info.

• txtParameter field contains a structure like this:

<?xml version="1.0" encoding="utf-8" ?>
<trackstart>
	<imei>123456789012345</imei>
	<description><![CDATA[titolo della traccia]]></description>
	<color1>00ffff</color1>
	<color2>00ff00</color2>
	<public>1</public>
	<updateposition>1</updateposition>
	<time>20101112173025</time>
</trackstart>

{
  "trackstart": {
    "imei": "123456789012345",
    "description": "titolo della traccia",
    "color1": "00ffff",
    "color2": "00ff00",
    "public": "1",
    "updateposition": "1",
    "time": "20101112173025"
  }
}

Where

• <imei> mandatory. It is the IMEI of the device which refers to the track. If the IMEI is associated to a consumer then the track will be associated to that consumer, otherwise the track's consumer will be set to “undefined”.

• <description> optional. It is the track's description. Can be equal to other saved tracks. If set overwrites the IMEI default description's text.

• <color1> optional. Track line color. It is in rrggbb format. Default value is ffff00. If set overwrites the IMEI default line's color.

• <color2> optional. Altitude transparency color. It is in rrggbb format. Default value is 00ff00. If set overwrites the IMEI default altitude's color.

• <public> optional. If set overwrites the IMEI default track type value. Can be:

  • 0 (zero) if the track has to remain private and visible only to his owner.
  • 1 (one) if the track has to be published in a page to share with friends.
  • 2 if the track has to be public.

• <updateposition> optional. If set overwrites the IMEI default radar value. Can be:

  • 0 (zero) if trackpoint command does not have to update current user's position.
  • 1 (one) if trackpoint command have to update current user's position.

• <time> mandatory, date and time in UTC. The accepted format is “yyyyMMddhhmmss”.

• txtProvider field must contain the application calling ID and generated characters.

• txtSignature field must contain the signature based on the string made of “Command Name” + “time” + portion of track title, without spaces, to reach 32 character + “generated character to 32”.

Looking at the previous example, the string on which calculate the check will be:
“trackstart20101112173025titolode”

Therefore the txtProvider field will be:
“76a865d4-fab8-51cd-ba78-2da325f6955a”

Returns a structure like the following:

<?xml version="1.0" encoding="utf-8" ?>
<furesult>
	<message><![CDATA[ OK ]]></message>
	<id>1260</id>
</furesult> 

{
  "furesult": {
    "message": " OK ",
    "id": "1260"
  }
}