Reference for http://apisandbox.inapub.co.uk/api.svc/postcodes/?lat={LATITUDE}&lng={LONGITUDE}&page={PG}&appID={APPID}

Get a page from the list of postcodes that are near the provided longitude and latitude, returned as XML by default. *** WE USE GEONAMES (HTTP://WWW.GEONAMES.ORG/) TO DO THE REVERSE GEOCODE LOOKUP. IF YOU USE THIS URL YOU SHOULD GIVE CREDIT TO GEONAMES AND SHOW THE FOLLOWING LINK: HTTP://WWW.GEONAMES.ORG/ ***

Url: http://apisandbox.inapub.co.uk/api.svc/postcodes/?lat={LATITUDE}&lng={LONGITUDE}&page={PG}&appID={APPID}

HTTP Method: GET

This operation supports JSONP responses. The callback function can be specified using the "callback" Url query parameter.

Message direction Format Body
Request N/A The Request body is empty.
Response Xml Example,Schema
Response Json Example

The following is an example response Xml body:

<Postcodes xmlns="http://schemas.datacontract.org/2004/07/EventilityAPI.DataContracts">
  <PostcodeList>
    <Postcodes.Postcode>
      <Distance>1.26743233E+15</Distance>
      <Postalcode>String content</Postalcode>
    </Postcodes.Postcode>
    <Postcodes.Postcode>
      <Distance>1.26743233E+15</Distance>
      <Postalcode>String content</Postalcode>
    </Postcodes.Postcode>
  </PostcodeList>
  <TotalPostcodeCount>2147483647</TotalPostcodeCount>
</Postcodes>

The following is an example response Json body:

{
	"PostcodeList":[{
		"Distance":1.26743233E+15,
		"Postalcode":"String content"
	}],
	"TotalPostcodeCount":2147483647
}

The following is the response Xml Schema:

<xs:schema xmlns:tns="http://schemas.datacontract.org/2004/07/EventilityAPI.DataContracts" elementFormDefault="qualified" targetNamespace="http://schemas.datacontract.org/2004/07/EventilityAPI.DataContracts" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexType name="Postcodes">
    <xs:sequence>
      <xs:element minOccurs="0" name="PostcodeList" nillable="true" type="tns:ArrayOfPostcodes.Postcode" />
      <xs:element minOccurs="0" name="TotalPostcodeCount" type="xs:int" />
    </xs:sequence>
  </xs:complexType>
  <xs:element name="Postcodes" nillable="true" type="tns:Postcodes" />
  <xs:complexType name="ArrayOfPostcodes.Postcode">
    <xs:sequence>
      <xs:element minOccurs="0" maxOccurs="unbounded" name="Postcodes.Postcode" nillable="true" type="tns:Postcodes.Postcode" />
    </xs:sequence>
  </xs:complexType>
  <xs:element name="ArrayOfPostcodes.Postcode" nillable="true" type="tns:ArrayOfPostcodes.Postcode" />
  <xs:complexType name="Postcodes.Postcode">
    <xs:sequence>
      <xs:element minOccurs="0" name="Distance" type="xs:double" />
      <xs:element minOccurs="0" name="Postalcode" nillable="true" type="xs:string" />
    </xs:sequence>
  </xs:complexType>
  <xs:element name="Postcodes.Postcode" nillable="true" type="tns:Postcodes.Postcode" />
</xs:schema>

Additional response Xml Schemas:

<xs:schema xmlns:tns="http://schemas.microsoft.com/2003/10/Serialization/" attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://schemas.microsoft.com/2003/10/Serialization/" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="anyType" nillable="true" type="xs:anyType" />
  <xs:element name="anyURI" nillable="true" type="xs:anyURI" />
  <xs:element name="base64Binary" nillable="true" type="xs:base64Binary" />
  <xs:element name="boolean" nillable="true" type="xs:boolean" />
  <xs:element name="byte" nillable="true" type="xs:byte" />
  <xs:element name="dateTime" nillable="true" type="xs:dateTime" />
  <xs:element name="decimal" nillable="true" type="xs:decimal" />
  <xs:element name="double" nillable="true" type="xs:double" />
  <xs:element name="float" nillable="true" type="xs:float" />
  <xs:element name="int" nillable="true" type="xs:int" />
  <xs:element name="long" nillable="true" type="xs:long" />
  <xs:element name="QName" nillable="true" type="xs:QName" />
  <xs:element name="short" nillable="true" type="xs:short" />
  <xs:element name="string" nillable="true" type="xs:string" />
  <xs:element name="unsignedByte" nillable="true" type="xs:unsignedByte" />
  <xs:element name="unsignedInt" nillable="true" type="xs:unsignedInt" />
  <xs:element name="unsignedLong" nillable="true" type="xs:unsignedLong" />
  <xs:element name="unsignedShort" nillable="true" type="xs:unsignedShort" />
  <xs:element name="char" nillable="true" type="tns:char" />
  <xs:simpleType name="char">
    <xs:restriction base="xs:int" />
  </xs:simpleType>
  <xs:element name="duration" nillable="true" type="tns:duration" />
  <xs:simpleType name="duration">
    <xs:restriction base="xs:duration">
      <xs:pattern value="\-?P(\d*D)?(T(\d*H)?(\d*M)?(\d*(\.\d*)?S)?)?" />
      <xs:minInclusive value="-P10675199DT2H48M5.4775808S" />
      <xs:maxInclusive value="P10675199DT2H48M5.4775807S" />
    </xs:restriction>
  </xs:simpleType>
  <xs:element name="guid" nillable="true" type="tns:guid" />
  <xs:simpleType name="guid">
    <xs:restriction base="xs:string">
      <xs:pattern value="[\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12}" />
    </xs:restriction>
  </xs:simpleType>
  <xs:attribute name="FactoryType" type="xs:QName" />
  <xs:attribute name="Id" type="xs:ID" />
  <xs:attribute name="Ref" type="xs:IDREF" />
</xs:schema>

<tns:schema targetNamespace="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://www.w3.org/2001/XMLSchema">
  <tns:element name="schema">
    <tns:complexType />
  </tns:element>
</tns:schema>