Description
The Location API allows you to determine the current physical location of a terminal.
Use Cases
¢Mapping and directions
–Alice uses her handset browser to read a city restaurant review site, food.example.com. On finding a suitable restaurant, she clicks a link in the Web page to ‘send driving directions’. Food.example.com then queries the mobile operator for the user’s location. The operator sends back geographic coordinates which food.example.com use to create a set of text directions and map specific to Alice’s current location, and this is sent back to her as a Web page.
¢Live service finder
–Bob is a plumber who has registered with local.example.com, a Website which promotes local services. Charlie needs a plumber but does not want to pay a high call out charge as he lives outside town. Charlie accesses local.example.com and asks for a ‘currently nearby’ plumber. Local.example.com queries the operators of the 10 plumbers it has registered, discovers that Bob is nearby and responds to Charlie with Bob’s phone number.
Dependencies
To use the API you will need:
-
API authentication according to the GSMA API authentication process.
-
The MSISDN of the device that you wish to locate, or, an Anonymous Customer Reference provided by the operator.
Rules and policies
TBC: as sandbox implemenations of this API become available then we will provide links to the operator policies and terms of use.
Method Summary
getLocation (address, accuracy)
Parameter detail
|
Parameter Name |
Format and usage |
|
address |
Either an MSISDN including international calling code, e.g. 00441234123123;
|
|
accuracy |
Either 'coarse' or 'fine'. MANDATORY.
'coarse' will prioritise response time over accuracy, i.e. the API will respond as
soon as an approximate location has been determined.
'fine' will return a response as soon as location has been determined to within 10
metres (or as close as the network can achieve)
TODO: agree on approximate location - current town/city? |
Response detail
(SECTION TO BE COMPLETED)
Exceptions
(SECTION TO BE COMPLETED)