User Tools

Site Tools


map_suite_gps_tracking_server_device_gateway_overview

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Last revision Both sides next revision
map_suite_gps_tracking_server_device_gateway_overview [2015/09/25 03:09]
admin [Posting Data to the Device Gateway]
map_suite_gps_tracking_server_device_gateway_overview [2015/09/25 03:10]
admin [Posting Data to the Device Gateway]
Line 61: Line 61:
   ''<​DeviceID>''​ - Required element that contains the ID of the device that is posting the information. ​ If your device is using cellular technology, this is typically the IMEI or ESN number.   ''<​DeviceID>''​ - Required element that contains the ID of the device that is posting the information. ​ If your device is using cellular technology, this is typically the IMEI or ESN number.
   
-''<​UtcDateTime>''​ - Required element that contains the UTC time at which the information was received from the device.+  ''<​UtcDateTime>''​ - Required element that contains the UTC time at which the information was received from the device.
   
-''<​Longitude>''​ - Required element that contains the longitude (X) coordinate of the device'​s location.+  ''<​Longitude>''​ - Required element that contains the longitude (X) coordinate of the device'​s location.
   
-''<​Latitude>''​ - Required element that contains the latitude (Y) coordinate of the device'​s location.+  ''<​Latitude>''​ - Required element that contains the latitude (Y) coordinate of the device'​s location.
   
-''<​GpsAccuracyInMeters>''​ - Required element that represents the accuracy of the location coordinates that the device is reporting. ​ If you don't know the accuracy of your GPS device, we suggest you put a default value that is greater than 0.  (If you put 0, Map Suite GPS Tracking Server will disregard the location information and not trigger any location-based alerts.)+  ''<​GpsAccuracyInMeters>''​ - Required element that represents the accuracy of the location coordinates that the device is reporting. ​ If you don't know the accuracy of your GPS device, we suggest you put a default value that is greater than 0.  (If you put 0, Map Suite GPS Tracking Server will disregard the location information and not trigger any location-based alerts.)
   
-''<​AltitudeInMeters>''​ - Required element that represents the altitude of the location that the device is reporting. ​ If no altitude is known, put 0.+  ''<​AltitudeInMeters>''​ - Required element that represents the altitude of the location that the device is reporting. ​ If no altitude is known, put 0.
   
-''<​SpeedInKph>''​ - Required element that represents the current speed (in kilometers per hour) that the device is traveling at.+  ''<​SpeedInKph>''​ - Required element that represents the current speed (in kilometers per hour) that the device is traveling at.
   
-''<​Idle>''​ - Optional element that represents whether the device'​s status is idling or not. If you don't know or your device doesn'​t support idling, put 0.+  ''<​Idle>''​ - Optional element that represents whether the device'​s status is idling or not. If you don't know or your device doesn'​t support idling, put 0.
   
-''<​Heading>''​ - Required element representing the current heading in degrees (0-360) that the device is reporting. ​ If no heading is known, put 0.+  ''<​Heading>''​ - Required element representing the current heading in degrees (0-360) that the device is reporting. ​ If no heading is known, put 0.
   
-''<​RawDebugMessage>''​ - Required element representing the entire raw message from the device before it was parsed. ​ This information can sometimes be helpful for troubleshooting and debugging device problems. ​ If no debugging information is needed, you can leave this element blank.+  ''<​RawDebugMessage>''​ - Required element representing the entire raw message from the device before it was parsed. ​ This information can sometimes be helpful for troubleshooting and debugging device problems. ​ If no debugging information is needed, you can leave this element blank.
   
-''<​DeviceAlerts>''​ - Optional element that will contain one or many ''<​DeviceAlert>''​ elements (see below).+  ''<​DeviceAlerts>''​ - Optional element that will contain one or many ''<​DeviceAlert>''​ elements (see below).
   
-''<​DeviceAlert>''​ - Optional element that represents a device triggered alert. ​ One &​lt;​DeviceAlert&​gt;​ element should be included for each alert that will be triggered. ​ For example, if you had both an AirBag alert and an OpenDoor alert triggered, there would be two <​DeviceAlert>​ elements, one for each individual alert.+    ''<​DeviceAlert>''​ - Optional element that represents a device triggered alert. ​ One &​lt;​DeviceAlert&​gt;​ element should be included for each alert that will be triggered. ​ For example, if you had both an AirBag alert and an OpenDoor alert triggered, there would be two <​DeviceAlert>​ elements, one for each individual alert.
   
-''<​CustomData>''​ - Optional element that will contain one or many child ''<​CustomData>''​ elements (see below).+  ''<​CustomData>''​ - Optional element that will contain one or many child ''<​CustomData>''​ elements (see below).
   
-''<​CustomData Name="​Custom Data Name" MIMEType="​Data Type">''​ - Optional element that represents any custom data that the device may be providing. ​ This element also has two attributes called ''​Name''​ and ''​MIMEType''​. ​ The ''​Name''​ attribute controls the name that you want to give to the CustomData (for instance, "Photo File" or "​Engine RPM") while the ''​MIMEType''​ attribute represents the MIME type of the custom data (for instance, "​image/​jpeg"​ or "​text/​plain"​). ​ For reference, here is [[http://​www.utoronto.ca/​webdocs/​HTMLdocs/​book/​book-3ed/​appb/​mimetype.html|a list of available MIME types]].+    ''<​CustomData Name="​Custom Data Name" MIMEType="​Data Type">''​ - Optional element that represents any custom data that the device may be providing. ​ This element also has two attributes called ''​Name''​ and ''​MIMEType''​. ​ The ''​Name''​ attribute controls the name that you want to give to the CustomData (for instance, "Photo File" or "​Engine RPM") while the ''​MIMEType''​ attribute represents the MIME type of the custom data (for instance, "​image/​jpeg"​ or "​text/​plain"​). ​ For reference, here is [[http://​www.utoronto.ca/​webdocs/​HTMLdocs/​book/​book-3ed/​appb/​mimetype.html|a list of available MIME types]].
  
 Once you have created a valid XML document, the only thing left to do is populate the ''​XMLmessage''​ parameter and execute the web method. ​ Once you do, the new data should be visible in your Map Suite GPS Tracking Server web portal within a few seconds. Once you have created a valid XML document, the only thing left to do is populate the ''​XMLmessage''​ parameter and execute the web method. ​ Once you do, the new data should be visible in your Map Suite GPS Tracking Server web portal within a few seconds.
map_suite_gps_tracking_server_device_gateway_overview.txt · Last modified: 2015/09/25 03:11 by admin