The Parlay X Terminal Location over Parlay Web service implementation, uses the Usage Record component Web service to record events related to a service request.
Usage records for Parlay X Terminal Location over Parlay are created by calling the Usage Record component Web service, which creates entries in the USAGERECORDS table.
Attribute | Description |
---|---|
RECORDID | A unique record identifier |
SEGMENT | Segment number used for subsequent truncated records. This number is incremented each time an overflow of the SERVICEDATA field is encountered and a subsequent record is added. Used by the SMS-based service implementations; a value of 0 is written for all others. |
GLOBALID | Global transaction identifier |
SERVICE | Name of the service |
HOST | Name of the host on which the usage record is being recorded |
EVENTTYPE | Name of the operation being performed |
RECORDTIME | The time that the usage record was written |
STATUSCODE | One of the following: 0 = VALID |
SERVICEDATA | Semicolon-delimited list of attributes described in the following tables, written in the format key=value;key=value... |
Attribute | Description |
---|---|
RESULT_CURRENCY | Timestamp of the result |
START_TIME | Time the operation began |
REQUEST_ACCEPTABLE_ACCURACY | Lowest accuracy acceptable to requester |
IS_ALTITUDE_REQUESTED | Determines whether altitude information should
be requested when location requests are made. Has to be one of the
following: Yes |
REQUESTED_DELAY_TOLERANCE | Priority of response time versus accuracy. Has
to be one of the following: P_M_DELAY_TOLERANT |
REQUESTER | Requester name requesting this operation |
RESULT_ACCURACY | Accuracy of the resulting location |
REQUESTED_RESPONSE_TIME | Maximum time that the application can accept to wait for a response |
IS_USING_EXTENDED_REQUEST | Whether extended location requests should be
made. Has to be one of the following: Yes |
REQUESTED_MAXIMUM_AGE_OF_RESPONSE | Maximum acceptable age of the location information that is returned |
SERVICE | Service name requesting this operation |
TARGET | Formatted target address |
ASSIGNMENT_ID | Parlay assignment ID associated with the request |
RESPONSE_TIME | Amount of time to take for the response |
REQUESTED_ACCURACY | Accuracy of location information requested |
LOCATION_METHOD | Parlay gateway location method strings |
LOCATION_TYPE | Parlay gateway location type strings. Has to
be one of the following: P_M_CURRENT_OR_LAST_KNOWN |
REQUEST_PRIORITY | Location priority parameter passed to the Parlay
gateway. Has to be one of the following: P_M_NORMAL |
Attribute | Description |
---|---|
IS_ALTITUDE_REQUESTED | Determines whether altitude information should
be requested when location requests are made. Has to be one of the
following: Yes |
REQUESTED_DELAY_TOLERANCE | Priority of response time versus accuracy. Has
to be one of the following: P_M_DELAY_TOLERANT |
REQUESTER | Requester name requesting this operation |
RESULT_ACCURACY | Accuracy of the resulting location |
REQUESTED_RESPONSE_TIME | Maximum time that the application can accept to wait for a response |
REQUESTED_MAXIMUM_AGE_OF_RESPONSE | Maximum acceptable age of the location information that is returned |
IS_USING_EXTENDED_REQUEST | Whether extended location requests should be
made. Has to be one of the following: Yes |
SERVICE | Service name requesting this operation |
TARGET | Formatted target address |
ASSIGNMENT_ID | Parlay assignment ID associated with the request |
RESPONSE_TIME | Amount of time to take for the response |
REQUESTED_ACCURACY | Accuracy of location information requested |
LOCATION_METHOD | Parlay gateway location method strings |
LOCATION_TYPE | Parlay gateway location type strings. Has to
be one of the following: P_M_CURRENT_OR_LAST_KNOWN |
REQUEST_PRIORITY | Location priority parameter passed to the Parlay
gateway. Has to be one of the following: P_M_NORMAL |
RESULT_CURRENCY | Timestamp of the result |
START_TIME | Time the operation began |
Attribute | Description |
---|---|
RESULT_ACCURACY | Accuracy of the resulting location |
REQUESTED_RESPONSE_TIME | Maximum time that the application can accept to wait for a response |
IS_USING_EXTENDED_REQUEST | Whether extended location requests should be
made. Has to be one of the following: Has to be one of the following: Yes |
REQUESTED_MAXIMUM_AGE_OF_RESPONSE | Maximum acceptable age of the location information that is returned |
SERVICE | Service name requesting this operation |
TARGET | Formatted target address |
ASSIGNMENT_ID | Parlay assignment ID associated with the request |
RESPONSE_TIME | Amount of time to take for the response |
REQUESTED_ACCURACY | Accuracy of location information requested |
LOCATION_METHOD | Parlay gateway location method strings |
LOCATION_TYPE | Parlay gateway location type strings. Has to
be one of the following: P_M_CURRENT_OR_LAST_KNOWN |
REQUEST_PRIORITY | Location priority parameter passed to the Parlay
gateway. Has to be one of the following: P_M_NORMAL |
RESULT_CURRENCY | Timestamp of the result |
START_TIME | Time the operation began |
REQUEST_ACCEPTABLE_ACCURACY | Lowest accuracy acceptable to requester |
IS_ALTITUDE_REQUESTED | Determines whether altitude information should
be requested when location requests are made. Has to be one of the
following: Yes |
REQUESTED_DELAY_TOLERANCE | Priority of response time versus accuracy. Has
to be one of the following: P_M_DELAY_TOLERANT |
REQUESTER | Requester name requesting this operation |
Attribute | Description |
---|---|
REQUESTER | Requester name requesting this operation |
RESULT_ACCURACY | Accuracy of the resulting location |
REQUESTED_RESPONSE_TIME | Maximum time that the application can accept to wait for a response |
IS_USING_EXTENDED_REQUEST | Whether extended location requests should be
made. Has to be one of the following: Yes |
REQUESTED_MAXIMUM_AGE_OF_RESPONSE | Maximum acceptable age of the location information that is returned |
REQUESTED_MAXIMUM_NOTIFICATION_FREQUENCY | Maximum frequency of a notification request |
SERVICE | Service name requesting this operation |
DURATION | Maximum duration of a notification request |
NOTIFICATION_EXPIRES_AT | Expiration time of the notification |
TARGET | Formatted target address |
LOCATION_METHOD | Parlay gateway location method strings |
NOTIFICATION_CRITERIA | Indicates whether the notification should occur
when the terminal enters or leaves the target area. Has to be one
of the following: P_UL_LEAVING_AREA |
LOCATION_TYPE | Parlay gateway location type strings. Has to
be one of the following: P_M_CURRENT_OR_LAST_KNOWN |
REQUEST_PRIORITY | Location priority parameter passed to the Parlay
gateway. Has to be one of the following: P_M_NORMAL |
RESULT_CURRENCY | Timestamp of the result |
START_TIME | Time the operation began |
NOTIFICATION_TRIGGER_RADIUS | Requested triggered radius |
NOTIFICATION_ENDPOINT | Endpoint URL that will receive the notifications |
CORRELATOR | Correlation information from the end point. Used to communicate with endpoint for callbacks, this information must be unique for this service and requester. |
NOTIFICATION LIMIT | Notification limit |
REQUEST_ACCEPTABLE_ACCURACY | Lowest accuracy acceptable to requester |
IS_ALTITUDE_REQUESTED | Determines whether altitude information should
be requested when location requests are made. Has to be one of the
following: Yes |
REQUESTED_DELAY_TOLERANCE | Priority of response time versus accuracy. Has
to be one of the following: P_M_DELAY_TOLERANT |
ASSIGNMENT_ID | Parlay assignment ID associated with the request |
RESPONSE_TIME | Amount of time to take for the response |
REQUESTED_ACCURACY | Accuracy of location information requested |
Attribute | Description |
---|---|
CORRELATOR | Correlation information from the end point. Used to communicate with endpoint for callbacks, this information must be unique for this service and requester. |
FREQUENCY | Frequency of a notification request |
REQUEST_PRIORITY | Location priority parameter passed to the Parlay
gateway. Has to be one of the following: P_M_NORMAL |
LOCATION_METHOD | Parlay gateway location method strings |
TARGET | Formatted target address |
ASSIGNMENT_ID | Parlay assignment ID associated with the request |
REQUESTER | Requester name requesting this operation |
SERVICE | Service name requesting this operation |
NOTIFICATION_EXPIRES_AT | Expiration time of the notification |
START_TIME | Time the operation began |
REQUESTED_DELAY_TOLERANCE | Priority of response time versus accuracy. Has
to be one of the following: P_M_DELAY_TOLERANT |
RESPONSE_TIME | Amount of time to take for the response |
DURATION | Maximum duration of a notification request |
REQUEST_ACCEPTABLE_ACCURACY | Lowest accuracy acceptable to requester |
NOTIFICATION_ENDPOINT | Endpoint URL that will receive the notifications |
REQUESTED_RESPONSE_TIME | Maximum time that the application can accept to wait for a response |
LOCATION_TYPE | Parlay gateway location type strings. Has to
be one of the following: P_M_CURRENT_OR_LAST_KNOWN |
IS_ALTITUDE_REQUESTED | Determines whether altitude information should be requested when location requests are made |
Attribute | Description |
---|---|
REQUESTER | Requester name requesting this operation |
SERVICE | Service name requesting this operation |
NOTIFICATION_TYPE | Notification type. Has to be one of the following: Triggered |
ASSIGNMENT_ID | Parlay assignment ID associated with the request |
RESPONSE_TIME | Amount of time to take for the response |
START_TIME | Time the operation began |
CORRELATOR | Correlation information from the end point. Used to communicate with endpoint for callbacks, this information must be unique for this service and requester. |
Attribute | Description |
---|---|
FAILURE_REASON | Error message identifier indicating the error |
FAILURE_DETAIL | A detailed error text message |
ERROR_TYPE | Type of error encountered |
Usage records are not generated for locationError, locationNotification, and locationEnd operations.