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

 

Where

  • <message> contains OK or Error description
  • <id> contains the Id of the track just created

If MyWakes server returns an error, the format of this answer is described in the error section.

Terms Of Use | Privacy Statement | Company info
  • © Cedac Sistemi srl
  • Head office: Via Toscana, 3 40035 Castiglione dei Pepoli (Italy) Tel.: +39 0534-93811 Fax: +39 0534-93899
  • Branch office: Via del Lavoro, 47 40033 Casalecchio di Reno (Italy)
  • Branch office: Via Parini, 1 40033 Casalecchio di Reno (Italy)
  • Share capital Euro 26,000.00 - Company Register of Bologna / VAT no / fiscal code 01695261204