Back to main index

2.1.1   Get the actual GPS position

The .in file

Attributes in [Head] section:

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

Attributes in [GPS] section: No attributes needed

Example .in file: This request gets the actual GPS position in a loop

[Head] Type=1 Mode=2 Blocking=0

The .out file

Attributes in [GPS] section:

• GPSResult: Result code

  GPSResult	Description
  -3	GPS loop is already running
  -2	GPS not available
  -1	No fix
  1	GPS signal ok
  2	GPS loop startet

• GPSResultDesc: A textual description of GPSResult
• PositionGeodecimal: The actual GPS position in geographical notation
• PositionMercator: The actual GPS position in mercator notation
• Longitude: The longitude of the actual GPS position (in degrees * 1000000)
• Latitude: The latitude of the actual GPS position (in degrees * 1000000)
• Course: The actual direction
• Speed: The actual speed
• Satellites: Number of satellites used for GPS
• Altitude: The actual altitude in meters
• SatelliteTime: The actual time (hh:mm:ss) given by the satellites
• TimeSinceLastValidPos: The time span in milliseconds since the last valid GPS position

Attributes in [NavigationInformation] section:

• CurrentStreetName: The name of the street at the actual position
• RoadmatchedPosMercator: The actual roadmatched position in mercator notation
• RoadmatchedPosGeodecimal: The actual roadmatched position in geographical notation
• DistanceToTarget: The distance in meters to the navigation destination
• TimeToTarget: The estimated time in seconds to reach the navigation destination

Note: The [NavigationInformation] section only appears in the .out file when fleet navigator is currently in navigation mode.
Note: The attributes PositionGeodecimal, PositionMercator, Latitude, Longitude, Course and Satellites only appear in the .out file when GPSResult is positive
Note: The attributes Latitude and Longitude contain the same values as PositionGeodecimal. Latitude and Longitude are still there for downward compatibility reasons.

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

[Head] Type=1 TypeDesc=get gps info Mode=2 ModeDesc=loop Blocking=0 BlockingDesc=not blocking Timestamp=26376156 Id=26300046 Result=1 ResultDesc=success and request kept ExecuteDuration=156 [GPS] GPSResult=1 GPSResultDesc=signal ok Longitude=8431598 Latitude=49008112 PositionGeodecimal=+8.431599,+49.008112 PositionMercator=937551,6269214 Course=274 Speed=27 Satellites=5 Altitude=180 SatelliteTime=15:22:06 TimeSinceLastValidPos=67 [NavigationInformation] CurrentStreetName=Tullastraße RoadmatchedPosMercator=937562,6269208 RoadmatchedPosGeodecimal=+8.431698,+49.008071 DistanceToTarget=1117 TimeToTarget=145