Multiposter Web Service

Multiposter

Click here for a complete list of operations.

QueryLocations

Perform a location query. For a specific location specify LocationValue, or to search specify q (minimum 2 characters) along with a priority or prefix

q free text query (e.g. Cam)
prefix Results only in a specific country (e.g. US) or county (e.g. GB.EEEC for Cambridgeshire).
priority Give higher scores by country (e.g. US) or county (e.g. GB.EEEC for Cambridgeshire).
LocationValue Return the data for a specific known location e.g. GB.EEEC.0460 for Cambridge in Cambridgeshire.

Test

To test the operation using the HTTP POST protocol, click the 'Invoke' button.

Parameter	Value
sCultureID:
sAPIKey:
q:
prefix:
priority:
LocationValue:

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /SOAP/Multiposter.asmx HTTP/1.1
Host: api.logicmelon.co.uk
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://api.logicmelon.com/QueryLocations"

<?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>
    <QueryLocations xmlns="http://api.logicmelon.com/">
      <sCultureID>string</sCultureID>
      <sAPIKey>string</sAPIKey>
      <q>string</q>
      <prefix>string</prefix>
      <priority>string</priority>
      <LocationValue>string</LocationValue>
    </QueryLocations>
  </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>
    <QueryLocationsResponse xmlns="http://api.logicmelon.com/">
      <QueryLocationsResult>
        <CQueryLocation>
          <Display>string</Display>
          <LocationDescription>string</LocationDescription>
          <LocationID>int</LocationID>
          <LocationIdentifier>string</LocationIdentifier>
          <LocationValue>string</LocationValue>
          <Score>int</Score>
          <Latitude>decimal</Latitude>
          <Longitude>decimal</Longitude>
        </CQueryLocation>
        <CQueryLocation>
          <Display>string</Display>
          <LocationDescription>string</LocationDescription>
          <LocationID>int</LocationID>
          <LocationIdentifier>string</LocationIdentifier>
          <LocationValue>string</LocationValue>
          <Score>int</Score>
          <Latitude>decimal</Latitude>
          <Longitude>decimal</Longitude>
        </CQueryLocation>
      </QueryLocationsResult>
    </QueryLocationsResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /SOAP/Multiposter.asmx HTTP/1.1
Host: api.logicmelon.co.uk
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>
    <QueryLocations xmlns="http://api.logicmelon.com/">
      <sCultureID>string</sCultureID>
      <sAPIKey>string</sAPIKey>
      <q>string</q>
      <prefix>string</prefix>
      <priority>string</priority>
      <LocationValue>string</LocationValue>
    </QueryLocations>
  </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>
    <QueryLocationsResponse xmlns="http://api.logicmelon.com/">
      <QueryLocationsResult>
        <CQueryLocation>
          <Display>string</Display>
          <LocationDescription>string</LocationDescription>
          <LocationID>int</LocationID>
          <LocationIdentifier>string</LocationIdentifier>
          <LocationValue>string</LocationValue>
          <Score>int</Score>
          <Latitude>decimal</Latitude>
          <Longitude>decimal</Longitude>
        </CQueryLocation>
        <CQueryLocation>
          <Display>string</Display>
          <LocationDescription>string</LocationDescription>
          <LocationID>int</LocationID>
          <LocationIdentifier>string</LocationIdentifier>
          <LocationValue>string</LocationValue>
          <Score>int</Score>
          <Latitude>decimal</Latitude>
          <Longitude>decimal</Longitude>
        </CQueryLocation>
      </QueryLocationsResult>
    </QueryLocationsResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

GET /SOAP/Multiposter.asmx/QueryLocations?sCultureID=string&sAPIKey=string&q=string&prefix=string&priority=string&LocationValue=string HTTP/1.1
Host: api.logicmelon.co.uk

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<ArrayOfCQueryLocation xmlns="http://api.logicmelon.com/">
  <CQueryLocation>
    <Display>string</Display>
    <LocationDescription>string</LocationDescription>
    <LocationID>int</LocationID>
    <LocationIdentifier>string</LocationIdentifier>
    <LocationValue>string</LocationValue>
    <Score>int</Score>
    <Latitude>decimal</Latitude>
    <Longitude>decimal</Longitude>
  </CQueryLocation>
  <CQueryLocation>
    <Display>string</Display>
    <LocationDescription>string</LocationDescription>
    <LocationID>int</LocationID>
    <LocationIdentifier>string</LocationIdentifier>
    <LocationValue>string</LocationValue>
    <Score>int</Score>
    <Latitude>decimal</Latitude>
    <Longitude>decimal</Longitude>
  </CQueryLocation>
</ArrayOfCQueryLocation>

HTTP POST

The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /SOAP/Multiposter.asmx/QueryLocations HTTP/1.1
Host: api.logicmelon.co.uk
Content-Type: application/x-www-form-urlencoded
Content-Length: length

sCultureID=string&sAPIKey=string&q=string&prefix=string&priority=string&LocationValue=string

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<ArrayOfCQueryLocation xmlns="http://api.logicmelon.com/">
  <CQueryLocation>
    <Display>string</Display>
    <LocationDescription>string</LocationDescription>
    <LocationID>int</LocationID>
    <LocationIdentifier>string</LocationIdentifier>
    <LocationValue>string</LocationValue>
    <Score>int</Score>
    <Latitude>decimal</Latitude>
    <Longitude>decimal</Longitude>
  </CQueryLocation>
  <CQueryLocation>
    <Display>string</Display>
    <LocationDescription>string</LocationDescription>
    <LocationID>int</LocationID>
    <LocationIdentifier>string</LocationIdentifier>
    <LocationValue>string</LocationValue>
    <Score>int</Score>
    <Latitude>decimal</Latitude>
    <Longitude>decimal</Longitude>
  </CQueryLocation>
</ArrayOfCQueryLocation>