Address Field Lookup provides an abstracted API which enables addresses to be looked-up via any number of 'Address Field Lookup Services'. The module relies on Address Field for its underlying architecture. The scope of this module is to provide an addressfield handler that will provide postcode lookup functionality based on the default lookup service.
Dependencies
Features
- Abstracted API which allows any number of 'address field lookup services' to be defined.
- Ships with a sub-module providing integration with PCA Predict (formerly Postcode Anywhere).
- Comprehensive suite of hooks for providing services, altering data pre/post lookup and providing service-bespoke addressfield alterations.
- Test facility to check the validity of an 'Address Field Lookup Service'
Address Field Lookup Services
Address Field Lookup services can be defined through the module API, the main entry point for this being hook_addressfield_lookup_service_info
. Documentation can be found in addressfield_lookup.api.php
. Each service needs to provide its own handler class which implements the AddressFieldLookupInterface
defined within this module.
Each service is required to provide its own configuration interface via the form API. The actual details of the configuration can be fully bespoke to the
service.
PCA Predict (Formerly Postcode Anywhere)
The sub-module for PCA Predict (formerly Postcode Anywhere) provides its integration via the following web services:
The module has it's own configuration page at the following URL:
admin/config/regional/addressfield-lookup/postcodeanywhere/configure
To use this module you will a login and API key for PCA Predict (formerly Postcode Anywhere), which you can get from their sign-up page.
Installation
- Enable the Address Field Lookup module.
- Clear cache.
- Navigate to the field settings for an 'addressfield' field instance. Then select 'Address Field Lookup' as a format handler (see screenshot).
Configuration
Configuration for the module can be found at the following URL:
admin/config/regional/addressfield-lookup
This configuration page will allow to view all currently available address lookup services. You can choose the default service and configure each of the services individually.
All addressfield instances will have an 'Address Field Lookup' handler available.
Documentation
See README.txt in the module folder.
Version 2.x
Version 2.x of Address Field Lookup aims to create a more maintainable codebase and an easier process of integration for service developers. This version contains API breaking changes so anyone upgrading will see issues with 1.x integrations. For more details see API.txt in the module folder.
Attachment | Size |
---|---|
address-field-lookup-handler.png | 73.29 KB |
Project information
- Module categories: E-commerce
- 14 sites report using this module
- Created by danielmrichards on , updated
- Stable releases for this project are covered by the security advisory policy.
Look for the shield icon below.
Releases
Minor fix for european address premises
Development version: 7.x-2.x-dev updated 30 Aug 2016 at 20:58 UTC
Development version: 7.x-1.x-dev updated 15 Jun 2016 at 20:11 UTC