a delivery address selected from a suggestion is stored in a structured form rather than as free text.
A correct address before it reaches your systems
When someone places an order, creates an account or makes a booking, they do not always type a complete address. Woosmap offers them the relevant results from the first few characters, then hands your application a structured address, ready to use.
The Localities API plugs into a form, a search field or a map, on the web and in mobile apps.
When an incomplete address travels through your systems
Someone filling in an address wants to finish what they came to do. They may abbreviate, drop an apostrophe, stop halfway through a street name, or remember only the start of the postal code. A free-text field accepts all of it without raising anything.
What your system receives is unstructured input. It may be incomplete, ambiguous, or simply hard to use as it stands: before a delivery, an eligibility check or a customer record can rely on it, it often has to be completed, corrected, or split into street, city, postal code and coordinates. The work then happens after the fact, when picking the right address during input would have prevented the correction.
From the first character to a stored address
Four moments, from the input field to your database.
The user starts typing
They type the first characters into your address field, as in any other form. They stay in that one field, with no need to fill in street, city and postal code separately.
/autocomplete
Woosmap offers the addresses that match
Autocomplete returns up to 5 suggestions for the text entered, sorted by relevance. It matches on full words and on substrings, and it recognises common abbreviations and apostrophes, so relevant suggestions appear before they have finished typing.
The user picks the right address
They select a suggestion from the list. That gesture, not the typing, is what settles the address.
/details
Your application receives the complete address
Details returns the formatted address, its structured components and the coordinates with their accuracy level. Your form distributes them across its fields in a single action, and your business systems receive usable data rather than text to rework.
Three journeys where a reliable address is decisive
Three journeys whose outcome depends on the quality of the address you stored.
What Woosmap brings to that journey
- Relevant suggestions from the first characters
The search covers addresses, cities, postal codes, airports and other place types. You can restrict it to the countries you operate in.
- A complete address, and its components separated
Details returns the formatted address, its structured components and the coordinates with their accuracy level. That accuracy comes in four levels, from the rooftop of a building down to the city, and the documentation lists what is available country by country.
- Address data suited to the countries you operate in
Coverage is worldwide, with enhanced data quality in key regions: several countries are served by premium national address data, and the source behind it varies from one country to the next. Postal code search covers Western Europe, the USA and Canada.
Reducing input errors and manual corrections
"Woosmap helps us reduce customer address input errors which would require lengthy manual fixes or costly shipping errors."
Review on Capterra
Trusted by leading brands
For your engineering team
Two calls are enough to wire the journey above.
- The two calls, in this order
GET https://api.woosmap.com/localities/autocomplete/suggests, andGET https://api.woosmap.com/localities/detailscompletes. Autocomplete responses are for display purposes only: you must call the Details endpoint to get complete address data before storing, processing or displaying a location as a final result.- Keys, depending on where you call from
Client side requests use a public
key, which requires domain or IP restrictions. Server side requests use aprivate_key, or theX-Api-Keyheader.- The parameter people forget
Addresses are not included in the default results: set
types=addressto autocomplete them.components=country:restricts the search to the countries you name.- A debounce on the input
To keep request volume under control and adapt to how quickly users type, add a debounce to the input.
GET https://api.woosmap.com/localities/autocomplete/?input=main+st&types=address&components=country:us&key=YOUR_API_KEY
GET https://api.woosmap.com/localities/details?public_id=PUBLIC_ID_FROM_STEP_1&key=YOUR_API_KEYTake a public_id from the first response and pass it to the second: you get the list of suggestions, then the complete address with its address_components and its geometry.
Try the Autocomplete sample · Choose your integration path · Details API reference · Geocode addresses in batches
Start free, scale when you are ready
Free plan
Enough to wire the journey and test it, with no credit card.
- 10,000 free API requests per month
- Localities included
- Autocomplete requests count towards that allowance
PRODUCTION
Pro and Enterprise
What changes once the journey is live.
- Autocomplete requests are not charged
- 5,000 Details requests included each month
- Beyond that, Details follows the pricing that applies to it
An Autocomplete response is for display only: the Details call is the one that returns the address you store.
Some premium national address data requires a product activation, available on the Pro and Enterprise plans. Amounts and detailed tiers are on the pricing page: Autocomplete pricing · Details pricing
Questions we get
Woosmap does not retain the addresses entered or the suggestions selected after responding to the request. Our data processing agreement carries the contractual terms.
No. The Localities address database is not linked to names, surnames or phone numbers, so an address cannot be retrieved from a person.
The current product is the Localities API. The Address API is being deprecated across all subscriptions: use Localities for up to date address data, support and the improvements made to address search.
Yes, the Localities documentation publishes one: migration guide.
A 99.9% SLA is part of the Enterprise plan. The pricing page lists what each plan carries.
Yes. Woosmap can also be bought through the AWS Marketplace, which consolidates the subscription into your existing AWS invoice.
Next step
Localities is included in the Free plan, and no credit card is required to start. If your scope calls for more, our team will talk it through with you.