32.4 SDO_TRKR.SEND_LOCATION_MSGS
Format
SDO_TRKR.SEND_LOCATION_MSGS( tracking_set_name IN VARCHAR2, location_msgs IN LOCATION_MSG_ARR );
Description
Sends an array of new location information for objects that are being tracked in the tracking set.
Parameters
- tracking_set_name
-
Name of the tracking set.
- location_msgs
-
A message of type LOCATION_MSG_ARR.
- queue_no
-
The specific location queue that should be used for this location message. It is recommended that you not specify this parameter, in which case the tracking server determine the best queue for managing this location message.
Usage Notes
This procedure adds a new location message for tracking purposes. Whenever a new location is obtained for an object that is being tracked, this procedure can be used to update the location of that object.
The location_msgs
parameter is of type LOCATION_MSG_ARR, which is defined in Data Types for the Location Tracking Server.
Each message includes a timestamp value, which is the time of the update and is maintained along with the location information.
For conceptual and usage information about the location tracking server, see Location Tracking Server.
Examples
The following example adds a new location message. The message includes the object id (1), the current time, and the X and Y ordinates (2, 2) of the object's new location
EXECUTE SDO_TRKR.SEND_LOCATION_MSGS('TRACKING_EXAMPLE', LOCATION_MSG_ARR(location_msg(1, CURRENT_TIMESTAMP(), 2,2)));
Parent topic: SDO_TRKR Package (Location Tracking)