Try It

Operation: getLocationsX

This operation enables an application to request the location of a device. It can be used synchronously (to deliver a location result directly) or asynchronously (location result is retrieved in a subsequent operation).

Based on the synchronization method, getLocationsX returns one of the following results:

  • Elements related to the device location
  • geographical coordinates
  • time of the location
  • the shape used to represent the location area
  • the phone number of the device
  • speed
  • position method used
  • status of the location request (e.g., found/not found)
  • a request identifier that is used to retrieve the result of the locations via the operation getLocationsAnswer

Demo #1 Get a phone's location


Sample getLocationsX request: 
   <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:web="http://webservice.portico.locaid.net/">
     <soapenv:Header/>
     <soapenv:Body>
        <web:getLocationsX>
           <login>bogus@loc-aid.com</login>
           <password>blahblah</password>
           <classId>0O0O0</classId>
           <msisdnList>15612459468</msisdnList>
           <coorType>DECIMAL</coorType>
           <locationMethod>CELL</locationMethod>
           <syncType>SYN</syncType>
        </web:getLocationsX>
     </soapenv:Body>
  </soapenv:Envelope>
Sample getLocationsX response: 
 <S:Envelope   xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
     <S:Body>
        <ns2:getLocationsXResponse   xmlns:ns2="http://webservice.portico.locaid.net/">
           <return>
              <transactionId>2316005</transactionId>
              <locationResponse>
                 <coordinateGeo>
                    <format>DECIMAL</format>
                    <x>-122.39626305555555</x>
                    <y>37.79429638888889</y>
                 </coordinateGeo>
                 <direction/>
                 <geometry>
                    <inRadius>0.0</inRadius>
                    <outRadius>0.0</outRadius>
                    <radius>95.0</radius>
                    <startAngle>0.0</startAngle>
                    <stopAngle>0.0</stopAngle>
                    <type>CircularArea</type>
                 </geometry>
                 <locationTime>
                    <time>20100125201954</time>
                    <utc>-0000</utc>
                 </locationTime>
                 <number>15612459468</number>
                 <speed/>
                 <status>FOUND</status>
                 <technology>CELL</technology>
              </locationResponse>
           </return>
        </ns2:getLocationsXResponse>
     </S:Body>
  </S:Envelope>

Click here to get started.