New 42-day free trial
Smarty

An advanced look at US Autocomplete Pro API

WEBINAR RECAP: We hosted a webinar about Smarty’s US Autocomplete Pro API and how it differs from other autocomplete tools.
Andrew Townsend
Andrew Townsend
 • 
June 28, 2022
Tags

Improving address form completion rates—whether in a shopping cart, request for quote, or other form—can be a sinch if you’re using an address autocomplete tool. Not sure what that is? When you see an address line on a form and think “oh shoot this is going to take a minute” and then it fills it in after only a few keystrokes, that’s address autocomplete.

And no, not all address autocomplete tools are created equal.

Some check against their own address database only that is not frequently maintained. Some are only checked against the United States Postal Service database so they do not include non-postal addresses. And most do not have any sort of customization options when it comes to utilizing their APIs.

Smarty’s US Autocomplete Pro API checks against our incredibly large database of over 210+ million USPS addresses in addition to over 20 million non-postal addresses, and it is highly customizable.

Customizing for geolocation

One typical use for US Autocomplete is to assist an end user in entering their own address. In this case, you likely want to provide suggestions that are close to the user's location. The Geolocation feature, which is turned on by default, does just that. It uses data that maps the user's IP address to a city or surrounding area. It then places their city and state into the prefer_cities field.

Customizing for preferences

Another use for Autocomplete is for call centers where you may want to prefer suggestions that are in specific cities, states, or ZIP Codes. When set, these results will occupy the top percentage (prefer_ration) of the results.

Examples:

  • prefer_cities=SEATTLE, REDMOND,WA; RENO, NV
  • prefer_states=CO; OK
  • prefer_zip_codes=84660; 90210&prefer_geolocation=none

Customizing with include filters

Sometimes, you want to limit results to only specific cities, states, or ZIP Codes. This is different from preferences, which could provide suggestions outside your preference areas. Filters will only show suggestions that match the filter. Note that there are some keywords you can use for states that will filter on the 48 contiguous states (including DC), which exclude territories, Alaska and Hawaii. Or all states which exclude just the territories.

As with preferences, if you use the ZIP Code filter, you cannot use any other preference or filter.

Customizing with exclude filters

If you need to exclude specific states from your results, you can use this filter. It cannot be used with any other filter or the geolocation preference, but it works with other preference settings.

Customizing the source

US Autocomplete Pro has included non-postal addresses for a little over 6 months. Non-postal addresses are those that USPS won’t deliver to, but are valid physical addresses. By default, only postal addresses will be returned.

Set this to “all” if you also want to return non-postal addresses. You will know if a result is a non-postal address if it contains the source field with the value of “other.”

Customizing a selected secondary

This parameter gets it name from when a user selects an address to drill down on a particular secondary. This is the most complicated one of the options discussed in the webinar, but I’ll do my best to summarize.

If the address submitted is an apartment building with 100 units, this will dictate how many of those units there are and if the user can drill down to an exact unit. You can learn more about it in the recording below, beginning at 18:40.

View the webinar recording

This is just a brief overview of what was covered. You can view the full 26 minute video below.

Subscribe to our blog!
Learn more about RSS feeds here.
rss feed icon
Subscribe Now
Read our recent posts
Ecommerce shipping efficiency tools you need: Address autocomplete and verification
Arrow Icon
We know it’s not New Year's anymore, but we can still push for improvement and efficiency in our lives. Maybe you’ve lapsed on that goal to be healthier or slightly slipped on your new reading and writing regimen. No worries. Not only are we here to remind you to KEEP GOING on whatever goals you have, but we’re also here to give you an easy-to-implement solution that will create shipping efficiency and stop sending packages into the void. I mean, we’re assuming you don’t like wasting money. If you do… that’s how we’re different.
Patient form optimization: The $17.4 million problem
Arrow Icon
Let's start with a number that should make every hospital administrator do a double take: $17. 4 million. That’s how much the average hospital loses annually—just from denied claims due to patient misidentification. This isn’t from equipment costs, not from staffing shortages, and not even from insurance negotiations—just from keeping bad patient data. Surely, our forms aren’t that bad. (Yes, they are, and stop calling me Shirley. )But here’s the reality: According to the 2016 Ponemon Misidentification Report, 30% of hospital claims get denied, and over a third of those denials are caused by inaccurate or incomplete patient information.
The GPS adventures of a distracted developer
Arrow Icon
My name is Jeffrey Duncan, and at the pestering of Smarty’s editor, I’m writing a blog about the many adventures I’ve had in life and how address data has played a big part in them. I met my wife about eight years ago on a dating website. At the time, I lived in Provo, Utah, while she lived in Palmwoods, Australia, on the east coast of Queensland. On this dating app, I entered the area where I was interested in finding someone, about a 25-mile radius of Provo, Utah. I had no intention of leaving the valley, definitely not the state, and certainly not the country.

Ready to get started?