Simply Postcode Lookup Software

COM Object Features:

The COM Object has the following features:

• Out of the box solution Full Postcode Address Search solution
• Quick and Simple to add Full Address Search, by using implemented User Interface
• Offers full access to all data we provide (Full/Thoroughfare/Geographic Longitude and Latitude)
• Offers Advanced Word Search when using implemented User Interface
• Can be included in your own install routines
• Data always up to date
• No Data Administration Cost for you
• Can allow your customer to open an account, you get commission
• Can be run in local mode when internet is not available

COM Object Example Code

The COM Object examples:

   Download API Examples

Using the COM Object

The COM object install routine, “InstallSimplyPostcodeCOM.EXE” , is in the root directory of our example code. Or you can include the required files, found in directory "COM Object\COM Object Files", in your own install routine to ship with your bespoke software.

Creating the COM Object

Add a COM Reference to our COM object, “ISimplyPostCodeCOMClass”SimplyPostCodeLookup.dll, within your programming language.

VB6/VB.Net

Dim SimplyPostCodeLookup As New SimplyPostCode

Specify then 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. Note the prefix “I” or “W” denotes for “Internal” / “Web” use.

VB6/VB.Net

SimplyPostCodeLookup.SetDataKey(“I_KD352jKKHhk2GAFFKDU”)

For more information, about the COM object to implement Postcode Finder Software, click on the link below:

  Full Online API Reference Manual : COM Object

  Using the COM Object in Local Mode

If you are using Local data, as apposed to our internet based database, then you need to specify where the data file and license is.

  We recommend you use our web based address data for initial testing. Then when happy download and install the local data files

VB6/VB.Net

LMSetDataPath "X:\PAFDATA" SetDataKey "I"

When in local mode the Datakey is irrelevant, since the license is defined by the code entered in manager.exe (License manager, located in "X:\PAFDATA" in the above example). But we must specify “I” or “W” for Internal or External use.

Additional files needed

To use in local mode you need additional files to:

• Implement the Postcode Address finder database
• Allow the licenses to be unlocked
• Allow access to data files

For more information, about the COM object in Local mode, click on the link below:

  Full Online API Reference Manual : COM Object using Local Data

Getting Full address finder using the COM Object User Interface

Simply call SearchForFullAddressWithDialogue(PostcodePrima, Caption, ShowLicienceDetails, AllowManageAccount, DisplayErrors)

  This call can be used with Local Data or Internet based data.  But when using Local Data the advanced search is not available.

This function call will display a dialogue box for the user to enter the postcode to search for (or address words if using our Web Based data, more info). The user then presses the [FIND] button, and a list of possible addresses is displayed for the entered postcode. The user selects an appropriate address record and the address is returned.

Postcode Lookup Example:

This code displays the following Postcode Address Lookup window:

VB6

Function GetAddressByPostcode() As Boolean    On Error GoTo Error_loading    Set SimplyPostCodeLookup = CreateObject("ISimplyPostCodeCOMClass.SimplyPostCode")    SimplyPostCodeLookup.SetDataKey ("Your Data key")    If SimplyPostCodeLookup.SearchForFullAddressWithDialogue("", "Get Address", true, true, true) then       With SimplyPostCodeLookup          me.CompanyName = .Address_Organisation          me.Line1 = .Address_Line1          me.Line2 = .Address_Line2          me.Line3 = .Address_Line3          me.Town = .Address_Town          me.County = .Address_County          me.Postcode = .Address_Postcode       end with    end if    Set SimplyPostCodeLookup = Nothing Exit_error:    Exit Function Error_loading:    MsgBox "Simply Post Lookup COM Object has not been installed on this PC !!! Please install using                'InstallSimplyPostcodeCOM.EXE'", vbCritical, "Simply Postcode Lookup software"    Resume Exit_error End Function

VB.Net

'Set Data key, to identify your account SimplyPostCodeLookup.SetDataKey(Me.txtDataKey.Text) With SimplyPostCodeLookup    If .SearchForFullAddressWithDialogue(Me.txtPostcode.Text, "Get address using simple call to                .NET Assembly Object", True, True, True) Then       Me.CompanyName.text = .Address_Organisation       Me.Line1.text = .Address_Line1       Me.Line2.text = .Address_Line2       Me.Line3.text = .Address_Line3       Me.Town.text = .Address_Town       Me.County.text = .Address_County       Me.Postcode.text = .Address_Postcode    End If End With

C# .NET

//Set Data key, to identify your account string DataKey= "Your Data Key"; SimplyPostCodeLookup.SetDataKey(ref DataKey); //This calls the COM object to do all of the work! string PostCodeToFind = txtPostcode.Text; string Title = "Get address using simple call to .NET Assembly Object"; if (SimplyPostCodeLookup.SearchForFullAddressWithDialogue(PostCodeToFind, Title, true, true, true) == true) {    CompanyName.text = SimplyPostCodeLookup.Address_Organisation;    Line1.text = SimplyPostCodeLookup.Address_Line1;    Line2.text = SimplyPostCodeLookup.Address_Line2;    Line3.text = SimplyPostCodeLookup.Address_Line3;    Town.text = SimplyPostCodeLookup.Address_Town;    County.text = SimplyPostCodeLookup.Address_County;    Postcode.text = SimplyPostCodeLookup.Address_Postcode; }

Advanced Search Example:

This function adds an [Advanced Find] button to the search window provided by SearchForFullAddressWithDialogue call (See previous section). This allows users to enter address words to search for, to return Full address information:

When the [Advanced Find] button is pressed the following is displayed:

Results:

  This call can ONLY be used with Internet based data

For more information, about the COM Object to implement Postcode Finder Software for bespoke desktop software, click on the link below:

  Full Online API Reference Manual : COM Object

Getting Thoroughfare/Street address using the COM Object User Interface

Simply call GetThoroughfareAddressRecord(Postcode) as Boolean

This type of search will get most of the address, except the house name or number. The user then must enter this information themselves.

  This call can be used with Local Data or Internet based data. 

Simply call with the postcode to search for.

Postcode Lookup Example:

This code gets the Thoroughfare/Street address information from the Royal Mail address database.

VB6

With SimplyPostCodeLookup    PostcodeToSearchFor = "PE13 2QL"    If .GetThoroughfareAddressRecord(PostcodeToSearchFor) Then       ‘Process data       me.Line1 = .Address_line1       me.Line2 = .Address_line2    Else       'Show/Handle any errors       MsgBox .General_credits_display_text & vbCrLf & .General_errormessage,                         vbCritical,"Simply Postcode Lookup"    End If    'Show Credit/License in form caption    Me.Caption = .General_credits_display_text End With

VB.Net

'Set Data key, to identify your account SimplyPostCodeLookup.SetDataKey("Your Data Key") With SimplyPostCodeLookup    If .GetThoroughfareAddressRecord(Me.txtPostcode.Text) Then       Me.Line1.text = .Address_Line1       Me.Line2.text = .Address_Line2       Me.Line3.text = .Address_Line3       Me.Town.text = .Address_Town       Me.County.text = .Address_County       Me.Postcode.text = .Address_Postcode    Else       If .General_errormessage <> "" Then          MsgBox(.General_credits_display_text & vbCrLf & .General_errormessage,                   vbCritical, "Simply Postcode Lookup")       Else          MsgBox("Not found!")       End If    End If    Me.Text = "Simply Postcode Lookup : " & .General_credits_display_text End With

C# .NET

//Set Data key, to identify your account string DataKey= "Your Data Key"; string DataToShow= ""; string string crlf = "\r\n"; SimplyPostCodeLookup.SetDataKey(DataKey); string PostCodeToFind=txtPostcode.Text; if (SimplyPostCodeLookup.GetThoroughfareAddressRecord(PostCodeToFind) == true) {    MessageBox.Show(GetReturnedAddressDataToText( ), "Simply Postcode Lookup");    DataToShow = " line1 : " + SimplyPostCodeLookup.Address_Line1 + crlf;    DataToShow = DataToShow + " line2 : " + SimplyPostCodeLookup.Address_Line2 + crlf;    DataToShow = DataToShow + " line3 : " + SimplyPostCodeLookup.Address_Line3 + crlf;    DataToShow = DataToShow + " town : " + SimplyPostCodeLookup.Address_Town + crlf;    DataToShow = DataToShow + " county : " + SimplyPostCodeLookup.Address_County + crlf;    DataToShow = DataToShow + " postcode : " + SimplyPostCodeLookup.Address_Postcode + crlf;    //If low credit then can display button to buy more Credits/Licenses    //This is optional, but it is recommended to provide some means for the end    //Customer to purchase new Credits/Licenses from Simply Postcode Lookup Direct    if (SimplyPostCodeLookup.General_credits_display_showbutton==true)    {       ButtonBuyMore.Visible = true;    } else {       ButtonBuyMore.Visible = false;    } } else {    if (SimplyPostCodeLookup.General_errormessage != "" )    {       MessageBox.Show(SimplyPostCodeLookup.General_credits_display_text+" "+       SimplyPostCodeLookup.General_errormessage, "Simply Postcode Lookup");    } else {       MessageBox.Show("Not found!");    } } this.Text = "Simply Postcode Lookup : " + SimplyPostCodeLookup.General_credits_display_text;

For more information, about the COM Object to implement Postcode Finder Software for bespoke desktop software, click on the link below:

  Full Online API Reference Manual : COM Object