Web AJAX Thoroughfare UK Street Finder using PHP:
Using this Thoroughfare/Street Address Finder for your web site, the user:
- enters a postcode
- presses [Find Address] button
- has to enter the house name or number, the rest of the address is populated by the lookup
Please note : This demonstration uses demonstration data
unlike the live system
UK Street Finder functionality installed in minutes:
The above UK Street Finder functionality can be added to a PHP capable web server in minutes, floowing 5 easy steps, by simply dropping the supplied files into your Web project.
- Uses AJAX to populate web page, for a smooth customer experience
- "Out of the box" Postcode Address Search solution
- Very little programming required.
- Your Simply Postcode Lookup account codes are hidden from client
- Quick to install, Simply add two files into your Web site
- Will run on most Web servers
- Not blocked by Pop-up blockers
- No Data Administration Cost for you
- Latest up to date UK Royal Mail data from our reliable web servers
- Special test postcodes to test your PHP Street AJAX web postcode address finder
Web server capable of running PHP code, which is most web servers. See version for .NET
Web Site UK Street Finder in 5 steps:
Step 1 Sign up for 30 day 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 the Example Code
Simply download the example code. The code is in the "AJAX PHP Thoroughfare" directory of our example downloads. Simply copy, into the same directory as your web page which requires Street Finder Software , "SPL_AJAX_Street.js" and "SPLGetStreetAddress.php" files. Download code
If you wish to have two Thoroughfare/Street address postcode seaches on one web page, then please use the example in the “AJAX/AJAX ASP Full Address 2 Addresses” directory. It is significantly different from the single address fill example.
This line is showen in the "index.html" file included in the example download, as is the rest of the code.
|HTML Code in <head> in section|
Step 4 : Add a Link, button or image to activate UK Street Finder
Then add either a link, or button image, using the following code to activate the Postcode Lookup Web pop-up:
Example link to activate Street Finder Software:
|HTML Code (in your page)|
Lookup Address from link</a>
Example button to activate Finder Software:
|HTML Code (in your page)|
|<input type=button value="Lookup
This could easily be changed to use an image button.
Note: In the above example the Postcode Text field must have an ID of "postcode"
Step 5 : Map your Address fields
Example address field mappings:
Where the fields on your web page all have ID'd expressed:
<input type=text name=line1 id=line1
<input type=text name=line2 id=line2 size=45>
When using ASP Text boxes
Simply run up your page. Right click on page, select view source, and find the ID that ASP has assigned to your ASP Textbox controls.
Probably “MainContent_” is added to start and “ASP” at end if ID you have designated. Thus we could edit the writeback section to read:
| document.getElementById("MainContent_line1ASP").value = LINE1;
document.getElementById("MainContent_line2ASP").value = LINE2;
document.getElementById("MainContent_line3ASP").value = LINE3;
document.getElementById("MainContent_townASP").value = TOWN;
document.getElementById("MainContent_countyASP").value = COUNTY;
document.getElementById("MainContent_countryASP").value = COUNTRY;
Please note, if a major structure change, liek change in Master Page may change the ID's, but otherwise it should remain the same.
Step 6: Specify the Data Key
Open an account with us. Within seconds you will then receive a data key, by e-mail, which should be entered at the top of the "SPLGetStreetAddress.php" file. This key will enable your account, for a 30 day evaluation period, for one postcode area.
Identify your account:
|PHP Code (SPLGetStreetAddress.php)|
|$datakey = "PUT YOUR DATA KEY
Enter Postcode "ZZ99" to use test data. Test postcodes for various address formats.
Why do you have to have extra pages on your server?
Some browsers, especially if the client has turned up the security settings, may stop the client web page talking to a server from different domain. So by adding a page into your web domain, to relay the query to our Postcode address lookup server, removes this security problem.
Hides your account information from the Client Web Browser
Important PHP switches
In order to allow communication between your server and ours, a PHP setting must be set to allow communication PHP.INI file:
The following should be on:
; Whether to allow the treatment of URLs (like http:// or ftp://) as files.
allow_url_fopen = On
If this is off, then the code cannot get the address information from our server!
On most servers it is ON
How it Street Finder Software works
SPLGetStreetAddress.php code on your web server then calls our Street Finder Software web server for the address information, adding your account information, etc. This means the client browser never sees your account information.
When the SPLGetStreetAddress.php page receives address information from our server it simply relays it back to the web page (your page with address fields on the customers computer) on the client computer.
Function SPLhandleServerResponse then reads the XML, if it contains tag "<line1>" and writes the address information to your address fields on your web page. If the response does not contain "<line1>", because of invalid postcode entered, then it is not processed.