2.1.13   Start the recording of GPS positions

The .in file

Attributes in [Head] section:

Type: 13
Allowed Mode: 0 (try once), 1 (try until success), 2 (loop)
Allowed Blocking: 0 (non blocking), 1 (blocking)

Note: Loop mode is recommended, otherwise only one GPS position is recorded

Attributes in [GPSRecording] section:

• FileName: Name of the file where GPS positions are recorded to. This attribute is optional. Default is "gpsrecord.out".
• MaxFileSize: The maximum size in bytes of the file where GPS positions are recorded to. This attribute is optional. Default is 1048576. If the record file gets bigger than this value, the recording is stopped automatically.
• Interval: Interval in seconds for writing a GPS position to the recording file. This attribute is optional. Default is 10.
• OutputFormat: The coordinate format of the GPS position which is written to the recording file. This attribute is optional. Default is 1.

1	Mercator coordinate format
2	Geographical coordinate format

Example .in file: This request starts the recording of GPS positions in geographical format to the file "gpsrecord20050413.gps". The actual GPS position will be written to the specified file every 8 seconds. If the specified file reaches the size of 1 megabyte, the recording will be stopped.

[Head] Type=13 Mode=2 Blocking=0 [GPSRecording] FileName=gpsrecord20050413.gps MaxFileSize=1048576 Interval=8 OutputFormat=2

The .out file

Attributes in [GPSRecording] section:

• GPSRecordingResult: Result code

  GPSResult	Description
  -3	GPS recording file reached maximum file size
  -2	Error while opening GPS recording file
  -1	GPS recording already running
  1	GPS recording running

• GPSRecordingResultDesc: A textual description of GPSRecordingResult
• FileName: The FileName attribute given in the .in file
• MaxFileSize: The MaxFileSize attribute given in the .in file
• Interval: The Interval attribute given in the .in file
• OutputFormat: The OutputFormat attribute given in the .in file

Sample .out file: Resulting .out file from the above .in file example

[Head] Type=13 TypeDesc=start gps recording Mode=2 ModeDesc=loop Blocking=0 BlockingDesc=not blocking Timestamp=1387422546 Id=1387404796 Result=1 ResultDesc=success and request kept ExecuteDuration=63 [GPSRecording] GPSRecordingResult=1 GPSRecordingResultDesc=gps recording running FileName=gpsrecord20050413.gps MaxFileSize=1048576 Interval=8 OutputFormat=2

The recording file

The recording file is written to the same directory where the .in and .out-files are located.
Each line in the recording file represents the GPS position at a certain point in time.

Syntax of the recording file:
TimeStamp=Position

TimeStamp is the point in time when the GPS position was recorded. The TimeStamp syntax is YYYYMMDDhhmmss (YYYY = year, MM = month, DD = day, hh = hour, mm = minute, ss = second).
The GPS position is either in mercator or geographical format, depending on what you defined in the .in-File.

Sample recording file file:

20050414115143=+8.439351,+49.018275 20050414115146=+8.439351,+49.018275 20050414115149=+8.439360,+49.018269 20050414115152=+8.439365,+49.018263 20050414115155=+8.439369,+49.018261