SDK_TMCEvent Struct Reference

Data Fields
SDK_HDRINFO	size
SDK_HDRINFO	version
SDK_WCHAR_T	msgTxt [256]
SDK_INT2	msgTxtLC
SDK_INT2	uniqueCC
SDK_WCHAR_T	street [64]
SDK_WCHAR_T	fromLocation [64]
SDK_WCHAR_T	toLocation [64]
SDK_INT1	urgency
SDK_INT1	MGcat
SDK_INT1	MGsubcat
SDK_INT1	MGprio
SDK_INT4	timePenalty
SDK_BOOL	onCurrentRoute
SDK_BOOL	bWarningOnly
SDK_INT4	distanceToCurrentPosition
SDK_UINT4	state
SDK_WCHAR_T	stationInfo [9]
SDK_INT4	uniqueID
SDK_Position	pos
SDK_TMCEventBasic	basic

Detailed Description

Represent a single TMC event.

The complete information about a TMC event including its current status related to navigation is stored here.

Field Documentation

SDK_HDRINFO size

Size of struct - for controlling

SDK_HDRINFO version

Version of struct - for controlling. Use SDK_TMCEventVERSION

SDK_WCHAR_T msgTxt[256]

for future implementations (plain message text)

SDK_INT2 msgTxtLC

for future implementations (language code for message text)

SDK_INT2 uniqueCC

Unique country code. MGG proprietary unique country codes to overcome the shortcoming TMC standard. This gets determined by using the available position information. If there is no position information available the already loaded databases are searched for a matching country code. See ptv-proprietary TMC country codes for complete list.

SDK_WCHAR_T street[64]

Name of affected road ("On ") "A5" ("between")

SDK_WCHAR_T fromLocation[64]

Name of "from" location, e.g. "Bruchsal" (" and ")

SDK_WCHAR_T toLocation[64]

Name of "to" location, e.g. "Karlsruhe"

SDK_INT1 urgency

Urgency flag according to TMC Standard

SDK_INT1 MGcat

Proprietary category (see ptv-proprietary categories of TMC events for details)

SDK_INT1 MGsubcat

Proprietary sub-category (see ptv-proprietary categories of TMC events for details)

SDK_INT1 MGprio

Proprietary priority (see ptv-proprietary categories of TMC events for details)

SDK_INT4 timePenalty

Guess how much time the event may cost (by slowing down/waiting, etc.) [min]

SDK_BOOL onCurrentRoute

Flag to indicate if the event is on the current route

SDK_BOOL bWarningOnly

SDK_TRUE if the event won't affect the routing (e.g. a warning due to a motorist driving against the traffic on motorways)

SDK_INT4 distanceToCurrentPosition

Crowflight Distance to current position [m] Set by the Navigation SDK during navigation, not during tracking mode, etc. Note that this value is not updated within eahc call to SDK_GetGuidanceInformation() but based on a timer and requirements be rerouting, etc. Note that this value is not always reliable, since the SDK may even be used within having valid position information, etc.

SDK_UINT4 state

Status flag. 0: reserved 1: event is shown for the first time, no status assigned 2: event has been shown for the first time, still no status assigned 3: User does not want to honor that event while route calculation 4: User wants to honor that event while route calculation

SDK_WCHAR_T stationInfo[9]

Name of FM RDS station

SDK_INT4 uniqueID

Internal use.

SDK_Position pos

Position of the event

SDK_TMCEventBasic basic

Raw TMC data (as provided by the GNS API). Allow applications to implement their own TMC message decoding

---

The documentation for this struct was generated from the following file:

• SDKDef.h