“PostZon” Geographic Data - JSON API
To get a "Postzon" Geographical Data, including the distance between two postcodes, from our JSON Web Service we do the following:
Call JSONService/JSONSearchForPostZonData.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 JSON web service with your data key, which is e-mail to you when you open an account, and postcode.
www.simplylookupadmin.co.uk/JSONservice/JSONSearchForPostZonData.aspx?datakey=Your Data Key&postcode=pe132ql&homepostcode=BS20 6EL
Returns |
{ "found":"1", "credits_display_text":"Evaluation expires 31 Mar 2011", "accountadminpage":"https://www.simplylookupadmin.co.uk/WebAccountLogin.aspx? doid=1&coid=3333366462&Pay=yes", "errormessage":"", "pz_introductiondate":"19880254", "pz_gridrefeast":"54630", "pz_gridrefnorth":"30910", "pz_county":"12,Cambridgeshire", "pz_district":"UD,Fenland District", "pz_ward":"GT,Medworth Ward", "pz_usertype":"0,Small User", "pz_gridstatus":"1,Within building", "pz_country":"064,England", "pz_wardstatus":"1", "pz_nhs_code":"Q35,East of England", "pz_nhs_region":"Y51,", "pz_latitude_wgs84":"52.659857", "pz_longitude_wgs84":"0.1617", "pz_osreference":"TF4630009100", "pz_geodistancetohomepostcode":"239", "pz_postcode":"PE132QL" } |
If address returned then <found>=1, else <found>=0,error in <errormessage>
Note: The pz_geodistancetohomepostcode element contains the distance between:
- &postcode=PE132QL
- &homepostcode=BS20 6EL
Expressed in the parameters. If the optional &homepostcode parameter is omitted then this will be 0.
Data Returned
See data returned by Geographical data
more information about getting distance/Longitude/Latitude using JSON web service.
Related "Geographic" topics
Features | SOAP API |
HTTP/XML API | JSON API |
NET API. | Data Returned |
Download Example Code | Request a Quote and Brochure |
Open a 30 day evaluation account |