The following guide provides illustrations to explain:
The address finder widget is responsible for orchestrating the user's input on your website's address fields and interacting with Addy's Address Autocomplete API to search for address suggestions.
There are multiple ways to deploy the address finder widget on your website:
After a search request is made in step 1, the Address Autocomplete API will retrieve a list of address suggestions that match the user's input. The widget will use the API response to display an autocomplete list of addresses that the user can choose from. The user can use their keyboard or mouse to move up and down the list of address suggestions.
A user can validate their address by clicking on an address suggestion. When the user clicks on their address, the widget will make a call to the Address Details API and retrieve detailed information about the address such as the suburb, city, postcode and geo coordinates.
The Address Details API will securely log that a completed address request was made and subtract it from the 500 free completed address lookup requests available for that month. When a website exceeds the 500 free completed address requests per month, additional requests will count towards that month's invoice.
The address finder widget will use the response from the Address Details API in step 3 above to populate all of the registered address fields on the page.
Using the address finder widget and address APIs, users can complete address forms fast and accurately. Businesses and users will have confidence that goods will be delivered to the right place with a complete, consistent and validated address.