Advisory Text Keywords Overview


Advisory Text Keywords



The advisory text display is a useful function that allows you to display up to 4 lines of text in an overlay manner on an open advisory image. Advisory text Keywords extend the usefulness of the advisory text fields by making it possible for you to embed dynamic fields in the displayed text. When you include one of the keywords in your advisory text, RASTRAC will automatically evaluate the keyword at time of advisory execution and display the evaluated result instead of the keyword. Valid keywords are available in the keyword dropdown list on the 'Advisory Settings...Name' dialog box and are also described below.

Keyword	Definition	Example evaluated result
{{ID}}	Vehicle ID	116103204156
{{VID}}	Vehicle Alias	PATROL
{{LAT}}	Latitude	N30 27 25.064
{{LON}}	Longitude	W097 47 36.167
{{UTMPOS}}	UTM Position	34TCQ 3472 1120
{{SPEED}}	Speed	24.5 mph
{{COURSE}}	Course	325 deg
{{ALTITUDE}}	Altitude	7500 feet
{{TIME}}	Vehicle's Time	18:12:32
{{DATE}}	Vehicle's Date	25JUN2004
{{PCTIME}}	Local PC Time	18:12:35
{{PCDATE}}	Local PC Date	25JUN2004
{{ADDRESS}}	Full Address	13706 Research Blvd., Austin TX 78750
{{STREET}}	Street Address	13706 Research Blvd.
{{CITY}}	City	Austin
{{COUNTY}}	County	Travis
{{STATE}}	State	TX
{{ZIPCODE}}	Zip Code	78750
{{EVENT}}	Event Name	Emergency!
{{RAWEVENT}}	Event (decimal)	99
{{DISTANCE}}	Distance Traveled	14 sm 359 ft
{{SATELLITES}}	Satellites	5
{{GPS}}	GPS State	Estimated
{{INPUTS}}	Inputs (text)	Ignition On Door Open In #3 Off
{{RAWINPUTS}}	Inputs (bits)	3
{{MESSAGE}}	Message (text)	Please send directions
{{NEARESTPOINT}}	Nearest Point	Manning
{{ANALOG1}}	Analog Input 1	128
{{ANALOG2}}	Analog Input 2	0
{{ANALOG3}}	Analog Input 3	255
{{ANALOG4}}	Analog Input 4	0
{{HDOP}}	HDOP	1.6
{{PDOP}}	PDOP	1.0
{{GDOP}}	GDOP	2.1
{{VDOP}}	VDOP	2.9
{{RATEOFCLIMB}}	Rate of Climb	1.0
{{CUSTOM1}}	Long Integer	0
{{CUSTOM2}}	Long Integer	0
{{CUSTOM3}}	Short Integer	0
{{CUSTOM4}}	Short Integer	0
{{CUSTOM5}}	Byte	0
{{CUSTOM6}}	Byte	0
{{CUSTOMTEXT1}}	ASCII Text
{{CUSTOMTEXT2}}	ASCII Text
{{CUSTOMTEXT3}}	ASCII Text
{{SENSOR1}}	Sensor 1	32.5
{{SENSOR2}}	Sensor 2	132.6
{{SENSOR3}}	Sensor 3	0.0
{{SENSOR4}}	Sensor 4	0.0
{{SENSOR5}}	Sensor 5	0.0
{{SENSOR6}}	Sensor 6	0.0
{{SENSOR7}}	Sensor 7	0.0
{{SENSOR8}}	Sensor 8	0.0
{{BATTERY}}	Battery Volts	12
{{AUXBATTERY}}	Auxiliary Battery (%)	100
{{ENGINEID}}	Engine Id	17
{{ENGINEHOURS}}	Engine Hours	1257
{{ODOMETER}}	Odometer (miles)	23456.1
{{ENGINERPM}}	Engine RPM	2750
{{ERRORCODE}}	Error Code	21
{{DRIVERID}}	Driver ID	34976
{{VIN}}	VIN	1HGCG6675WA026100

Advisory Keywords may be used anywhere in the Advisory Text lines. To be recognized by RASTRAC, the keyword MUST be enclosed within double braces, as shown above. A Keyword must be entirely contained on a single line; i.e., the keyword may not begin on one line and end on the next line. Using {{ID}} will always display the actual vehicle ID (not the alias). Using {{VID}} will display the vehicle alias if available otherwise the vehicle ID will be used. Not all modems support all of the fields listed. So, some keywords may not be available for a selected vehicle (e.g. {{DRIVERID}}, {{VIN}}, etc...).

Note: Keywords can also be used in the ‘Entry Application’ and ‘Exit Application’ strings (e.g. C:\Email\Email.exe {{ID}} – could send an e-mail to the vehicle ID entered if you had a program to send e-mails (Email.exe) with a vehicle ID (116103204156) as a command line argument).