“PostZon” Geographic Data - HTTP/XML API

To get a "Postzon" Geographical Data address from our HTTP/XML Web Service we do the following:

Call XMLService/XMLSearchForPostZonData.aspx to get PostZon record

This call will retrieve the PostZon Data for a given Postcode, OSRef, Longtitude/Latitude or by Town. This PostZon data is collected from many different source by the Royal mail. The most useful information is Distance (in Km) from Home Postcode, Longitude and Latitude.

Example:

Call HTTP web service with your data key, which is e-mail to you when you open an account, and postcode.

www.simplylookupadmin.co.uk/XMLservice/XMLSearchForPostZonData.aspx?datakey=Your Data key
&postcode=pe132ql&version=1&homepostcode=BS20 6EL

Returns

<?xml version="1.0" ?>
<data>
   <confirm>Yes</confirm>
   <demoon>0</demoon>
   <credits_display_text>Evaluation expires 10 May 2011</credits_display_text>
   <credits_display_color>0</credits_display_color>
   <credits_display_size>12</credits_display_size>
   <credits_display_bold>0</credits_display_bold>
   <credits_display_showbutton>1</credits_display_showbutton>
   <co_customerchargeoption>0</co_customerchargeoption>
   <accountadminpage>https://www.simplylookupadmin.co.uk/WebAccountLogin.aspx?
                     doid=1&amp;coid=3333305462&amp;Pay=yes</accountadminpage>

   <record>
      <pz_introductiondate>19880254</pz_introductiondate>
      <pz_gridrefeast>54630</pz_gridrefeast>
      <pz_gridrefnorth>30910</pz_gridrefnorth>
      <pz_county>12,Cambridgeshire</pz_county>
      <pz_district>UD,Fenland District</pz_district>
      <pz_ward>GT,Medworth Ward</pz_ward>
      <pz_usertype>0,Small User</pz_usertype>
      <pz_gridstatus>1,Within building</pz_gridstatus>
      <pz_country>064,England</pz_country>
      <pz_wardstatus>1</pz_wardstatus>
      <pz_nhs_code>Q35,East of England</pz_nhs_code>
      <pz_nhs_region>Y51,</pz_nhs_region>
      <pz_latitude_wgs84>52.659857</pz_latitude_wgs84>
      <pz_longitude_wgs84>0.1617</pz_longitude_wgs84>
      <pz_osreference>TF4630009100</pz_osreference>
      <pz_geodistancetohomepostcode>239</pz_geodistancetohomepostcode>
      <pz_postcode>PE132QL</pz_postcode>
   </record>
</data>

If address returned then <found>=1, else <found>=0,error in <errormessage>

Note: The <pz_geodistancetohomepostcode> contains the distance between: