Get Long/Lat from COM Object using PostZon Data:
To get a "Postzon" Geographical Data address from our COM Object we do the following:
Distance between two postcodes
The distance between two postcodes can be returned. Simply call with Postcode and “Home postcode” provided in the parameters. Our service will then return the distance in km. So approximate charges could be applied to a customer based on the straight line distance.
Postcode to Longitude/Latitude
This is the main use of PostZon data. Simply call with the target Postcode and the PostZon data service will return the Longitude and Latitude. Ideal for mapping and calculating distances.
Getting PostZon Data using the .Net Assembly
Step 1 Sign up for trial
Simply use the "Sign Up for Trial" link at top right of this page to open a trial account. We will then send you a data key, which is used to identify your account, when using the following service.
Step 2 Download .Net Assembly
The .NET Assembly is for use with any Desktop .NET project. It is written in Framework V2.0 so compatible with any framework from 2 upwards. It is almost identical to our COM object, but is implemented as a .NET Assembly. It is therefore easier to distribute within your .NET project, since it requires no extra files.
The .NET Assembly is in the “NET Assembly” directory of our example code.
How to distribute .NET Assembly
Simply include the “ISimplyPostCodeClass.dll” in your application directory.
Note: the .Net Assembly is for desktop applications compiled to 32 bits. It will run fine on 64 bit machines, but will not support an application compiled to 64 bits, as it uses Microsoft MDAC which does not support 64 bits.
Step 3 Creating the .NET Assembly
Copy the “ISimplyPostCodeClass.dll” in your application directory, and then add it to your project references. This can be found in the “NET Assembly” directory of our example code.
In C# or VB, simply right click on the project in the Solution Explorer. Select “Add Reference”. On the window that opens, click on the Browser tab. Now find and double click on “ISimplyPostCodeClass.dll” to add reference.
The class constructor takes a parameter of a working directory PATH. This directory is used to store the advanced search data used in combos if used. This must be a valid directory, and have WRITE permissions.
Public Class Form1
public partial class Form1 : Form
Step 4 Specify the Data Key
The Data Key will have been sent to you via an e-mail when you opened the account. It is also available under the “Data Key” tab of the online admin window. For the .NET Assembly you should use the data key beginning with "I_".
string DataKey="Your Data Key";
Step 5 Call GetPostZonAddressRecord to get PostZon record
Simply call GetPostZonAddressRecord (Postcode) as Boolean
This call will retrieve the PostZon Data for a given Postcode, OSRef, Longitude/Latitude or "Town, County". This PostZon data is collected from many different source by the Royal mail. The most useful information is Distance from Home Postcode (in Kilometers), Longitude and Latitude.
This call can be used with Local Data or Internet based data.
To get the PostZon record by OSRef, simply set postcode to the OSRef, when calling GetPostZonData.
To get the PostZon record by Longtitude/Latitude, (closest within 10Km) set postcode to the "Longtitude|Latitude" (separated by |).
Postcode Lookup Example:
This code will get PostZon data from our database:
'Set Data key, to identify your account
//Set Data key, to identify your account
To get distance between two points
GetDistance(Latitude1, Longtitude1, Latitude2, Longtitude2) As Double
Step 4 Testing
Final step is to test, to enable easy testing please use our special test postcodes.
PostZon Geographic data - Example Code
Simply download the example code. The code is in the "NET assembly/Csharp NET Assembly Example" or "NET assembly/VB NET Assembly Example" directory of our example downloads.
These two examples demonstrate postcode lookup software using PostZon data.
This type of license returns: (see example below)
Public PostZon_IntroductionDate As String
Public PostZon_Gridrefeast As String
Public PostZon_Gridrefnorth As String
Public PostZon_County As String
Public PostZon_District As String
Public PostZon_Ward As String
Public PostZon_Usertype As String
Public PostZon_Gridstatus As String (accuracy of the geographic data)
Public PostZon_Country As String
Public PostZon_Wardstatus As String
Public PostZon_NHS_code As String
Public PostZon_NHS_region As String
Public PostZon_Latitude_wgs84 As String
Public PostZon_Longitude_wgs84 As String
Public PostZon_OSreference As String
'This is not supported at present but may be in future
Public PostZon_DistanceToHomePostcode As String
'Distance from Home Postcode
More infromation on Geographic data returned by API