WebSphere brand IBM WebSphere Telecom Web Services Server, Version 7.1

Integrating with Parlay X Terminal Location over Parlay

The Parlay X Terminal Location over Parlay Web service implementation provides operations for sending Terminal Location requests and registering for Terminal Location notifications. This service implementation interacts with a Parlay gateway using a Parlay Connector.

Call flows

The following steps show an example of the call flow for Parlay X Terminal Location over Parlay:
  1. The application invokes a getLocation request.
  2. Parlay X Terminal Location over Parlay sends the request through the Parlay Connector to the Parlay gateway.
  3. The Parlay gateway sends the request to the appropriate server and waits for a response.
  4. The server sends a LocationInfo response to the SMSC.
  5. The Parlay gateway returns the response through the Parlay Connector to Parlay X Terminal Location over Parlay.
  6. Parlay X Terminal Location over Parlay sends the response to the application.

Interfaces

TerminalLocation
getLocation
Retrieves the location of a single terminal. The accuracy requested is the desired accuracy for the response. The acceptable accuracy is the limit acceptable to the requester. The URI provided is for a single terminal.
getLocationForGroup
Retrieves the location of a group of terminals. Its function is the same as GetLocation, except that a group URI is expected as input.
getTerminalDistance
Determines the distance of a single terminal from a location. The URI provided cannot be a group URI.
TerminalLocationNotificationManager
startGeographicalNotification
Registers an application server to receive a notification when a terminal enters or exits an area specified by a longitude, latitude, and radius.
startPeriodicNotification
Registers an application server to receive a notification at some given interval.
endNotification
De-registers an application server from receiving notifications.
TerminalLocationNotification
locationNotification
Sent to an application when a notification is received.
locationError
Sent to an application when a notification error occurs.
locationEnd
Indicates that the notifications have ended for this application; called when the duration or count for notifications has been completed.



Terms of use
(C) Copyright IBM Corporation 2009. All Rights Reserved.