4 Protocol Examples

To retrieve the location for the network identifiers of a client, the protocol client constructs the following WSDL message.

 <soap:Body>
   <GetLocationsRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
     <Entity>sip:voip_911_user1@contoscovdomain.com</Entity>
     <!-- <WAPBSSID>string</WAPBSSID> -->
     <RSSI>0</RSSI>
     <MAC>12-22-22-22-22-22</MAC>
     <!-- <ChassisID>base64Binary</ChassisID> -->
     <!-- <PortID>base64Binary</PortID> -->
     <SubnetID>192.168.0.0</SubnetID>
     <IP>192.168.0.244</IP>
   </GetLocationsRequest>
 </soap:Body>

The protocol server then responds with the following.<5>

 <soap:Body>
   <GetLocationsResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
     <ReturnCode>200</ReturnCode>
     <presenceList>
       <presence entity="sip:voip_911_user1@contoscovdomain.com" xmlns="urn:ietf:params:xml:ns:pidf">
         <tuple id="_LIS:0">
           <status>
             <geopriv xmlns="urn:ietf:params:xml:ns:pidf:geopriv10">
               <location-info>
                 <civicAddress xmlns="urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr">
                   <country>US</country>
                   <A1>WA</A1>
                   <A3>Redmond</A3>
                   <PRD />
                   <RD>163rd</RD>
                   <STS>Ave</STS>
                   <POD>NE</POD>
                   <HNO>3910</HNO>
                   <HNS />
                   <LOC>30/3351</LOC>
                   <NAM>Microsoft</NAM>
                   <PC>98052</PC>
                 </civicAddress>
               </location-info>
             </geopriv>
           </status>
         </tuple>
       </presence>
     </presenceList>
   </GetLocationsResponse>
 </soap:Body>

To retrieve the locations for the city, state, and country/region specified by a client, the protocol client constructs the following WSDL message.

 <soap:Body>
   <GetLocationsInCityRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
     <Entity>sip:voip_911_user1@vcontoscodomain.com</Entity>
     <Country>US</Country>
     <State>WA</State>
     <City>San Francisco</City>
   </GetLocationsInCityRequest>
 </soap:Body>

The protocol server then responds with the following.

 <soap:Body>
   <GetLocationsInCityResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
     <ReturnCode>404</ReturnCode>
   </GetLocationsInCityResponse>
 </soap:Body>