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:
- The application invokes a getLocation request.
- Parlay X Terminal Location over
Parlay sends
the request through the Parlay Connector to the Parlay gateway.
- The Parlay gateway sends the request to the appropriate server and waits
for a response.
- The server sends a LocationInfo response to the SMSC.
- The Parlay gateway returns the response through the Parlay Connector to Parlay X Terminal Location over
Parlay.
- 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.