Wednesday, 15 June, 2016 UTC


Summary

Today we’re excited to release Algolia Places, a fast and easy way to turn any HTML input into an address autocomplete.
See it live • Read the docs
One of our core missions at Algolia is to improve search-related user experiences. Address forms were high on our list because they are both difficult to build and, if done poorly, add friction at critical moments like sign up and check out. Our goal with Algolia Places is to provide something that’s both easy for developers to integrate and enjoyable for visitors to use. It’s also highly customizable and can be enriched with additional data sources.
Algolia Places is packaged as a simple, lightweight JavaScript library and is available on npm and jsDelivr. You can find comprehensive documentation and live examples on the Algolia Places website.
Beautiful by default
At Algolia we try to build tools with sensible design defaults. The Algolia Places JavaScript library displays a modern and clean dropdown menu from the moment you install it. A few lines of CSS are all you need to customize it to the exact look and feel of your site. All of the typo-tolerance & highlighting capabilities of the Algolia search API are already built in.
Easy to use & easy to extend
Here’s a snippet of code you can use to add Algolia Places to any <input> element on your site. No prior setup or API key required.
View the code on Gist.
In some cases, you’ll want to customize the type of data that is returned and how it is presented. Algolia Places exposes additional configuration options that allow you to:
  • Restrict search to specific countries.
  • Restrict search to specific types of places (e.g. country, city, address).
  • Search for and retrieve localized place names.
Combine Places results with search results
Algolia Places is compatible with the autocomplete.js library. You can easily build interfaces that combine address search results with other results from autocomplete.js data sources, including Algolia indices. Here’s an example. The Cities section contains results from Places and the Vacation Rentals section contains results from a conventional Algolia index.
Algolia Places is also compatible with instantsearch.js, a library for building full-page search-as-you-type experiences. See the advanced examples to learn more.
Try it now
Algolia Places is free up to 1,000 requests per day. This should be enough to get familiar with the service and deploy smaller applications to production.
Contact us at [email protected] if you’d like to use Algolia Places on a larger scale. We’re happy to discuss increased quotas or chat with you about custom plans.
Like many of our projects, Algolia Places is open source. The Github repository has everything you need to open issues, have conversations and submit pull requests. Beginners and experts contributions are welcomed.
What’s next?
We’re continuing to enrich the underlying data and add more features. We’re working on a detailed blog post about how we built Algolia Places with OpenStreetMap and GeoNames.
In the meantime we’re excited to get your feedback and hear about your experiences!
Try it now