Advantez

FindCity request and response SOAP examples

findCity

Find a city within a given country and region and return its geo-coordinates

Support Operations

SOAP 1.1

An example of a SOAP 1.1 request and response

POST /webkits/area.v1.1.service HTTP/1.1
Host: services.advantez.com
Content-Type: text/xml; charset=utf-8
Content-Length: length SOAPAction: "http://services.advantez.com/area/v1.1/findCity"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <findCity xmlns="http://services.advantez.com/area/v1.1">
      <advantezKey>string</advantezKey>
      <webServiceKey>string</webServiceKey>
      <countryIds>
        <int>int</int>
        <int>int</int>
      </countryIds>
      <regionIds>
        <int>int</int>
        <int>int</int>
      </regionIds>
      <provinceIds>
        <int>int</int>
        <int>int</int>
      </provinceIds>
      <cityName>string</cityName>
    </findCity>
  </soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length <?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <findCityResponse xmlns="http://services.advantez.com/area/v1.1">
      <findCityResult>
        <city name="string">
          <country id="int" name="string" />
          <region id="int" name="string" />
          <province id="int" name="string" />
          <geo lat="decimal" lng="decimal" />
        </city>
        <city name="string">
          <country id="int" name="string" />
          <region id="int" name="string" />
          <province id="int" name="string" />
          <geo lat="decimal" lng="decimal" />
        </city>
      </findCityResult>
      <result>successful or invalid-value or non-secure-protocol or unexpected-exception or invalid-proptrack-key or unauthorised-domain or invalid-webservice-key or invalid-advantez-key</result>
    </findCityResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

An example of a SOAP 1.2 request and response

POST /webkits/area.v1.1.service HTTP/1.1
Host: services.advantez.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length <?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
  xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <findCity xmlns="http://services.advantez.com/area/v1.1">
      <advantezKey>string</advantezKey>
      <webServiceKey>string</webServiceKey>
      <countryIds>
        <int>int</int>
        <int>int</int>
      </countryIds>
      <regionIds>
        <int>int</int>
        <int>int</int>
      </regionIds>
      <provinceIds>
        <int>int</int>
        <int>int</int>
      </provinceIds>
      <cityName>string</cityName>
    </findCity>
  </soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length <?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
  xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <findCityResponse xmlns="http://services.advantez.com/area/v1.1">
      <findCityResult>
        <city name="string">
          <country id="int" name="string" />
          <region id="int" name="string" />
          <province id="int" name="string" />
          <geo lat="decimal" lng="decimal" />
        </city>
        <city name="string">
          <country id="int" name="string" />
          <region id="int" name="string" />
          <province id="int" name="string" />
          <geo lat="decimal" lng="decimal" />
        </city>
      </findCityResult>
      <result>successful or invalid-value or non-secure-protocol or unexpected-exception or invalid-proptrack-key or unauthorised-domain or invalid-webservice-key or invalid-advantez-key</result>
    </findCityResponse>
  </soap12:Body>
</soap12:Envelope>