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)));