trackphoto

The command sends a georeferenced picture that will be linked to the open track. If there is not an open track the command will be ignored. The command works also for tracks with the “non defined” consumer.

The command use the input type=file element to upload a file to a server.

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: “trackphoto”.

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

• txtParameter field contains a structure like this:

<?xml version="1.0" encoding="utf-8" ?> 
<trackphoto> 
	<latitude>44.152147</latitude> 
	<longitude>11.854532</longitude> 
	<altitude>8000</altitude>
	<message>Panorama con Monte Rosa sullo sfondo</message>
	<time>20101112173025</time> 
</trackphoto>

{
  "trackphoto": {
    "latitude": "44.152147",
    "longitude": "11.854532",
    "altitude": "8000",
    "message": "Panorama con Monte Rosa sullo sfondo",
    "time": "20101112173025"
  }
}

Where

• <trackid> optional. If not present the picture will be linked to the current track for the “non defined” consumer.

• <latitude> optional. It is the point's latitude, expressed in degrees and decimal degree. The decimal separator must be the “.” (dot). In the case of Southern Hemisphere the value will be negative and then preceded by a minus sign. If not specified and the picture is georeferenced, MyWakes will use the picture's latitude.

• <longitude> optional. It is the point's longitude, expressed in degrees and decimal degree. The decimal separator must be the “.” (dot). In the case of Western Hemisphere the value will be negative and then preceded by a minus sign. If not specified and the picture is georeferenced, MyWakes will use the picture's longitude.

• <altitude> optional. It is the point's altitude expressed in feet. If not specified and the picture is georeferenced, MyWakes will use the picture's altitude.

• <message> optional. Description to link to the picture.

• <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” + “generated character to 32”.

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

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

Returns a structure like the following:

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

{
  "furesult": {
    "message": " OK "
  }
}