Product Update

Swiftcomplete launches Global Places API

By Chris Winfield

We're pleased to announce the release of the Swiftcomplete Global Places API, featuring:

Global city and location search API

The Global Places API is extremely flexible and can be used for general location searching, geocoding and data cleansing, either globally or for a list of specific countries (for address validation and postcode lookup, please check our Address Autocomplete service).

From today, customers already using our existing service in Great Britain can upgrade to the Global Places API for worldwide coverage by creating a new Places API key.

What is the new API?

The Global Places API is ideal for when you want to capture user's general location, and receive structured location information and coordinates for routing or plotting on a map.

Some use-cases include building store locators (finding the nearest click and collect point to a place or postcode), adding a city autocomplete to a contact form or extracting locations from blocks of text, but the flexibility of the API makes it easy to create your own bespoke location integration.

Key features

Worldwide search

The API allows worldwide cross-border searching without needing to preselect a country. It's possible to restrict searching to either just one country, or a list of countries by passing in a list of country codes.

Highly scalable worldwide searching is made possible by the new Swiftcomplete Location Platform.

Location biasing

Location biasing increases relevance by automatically prioritising results near the user's current location, determined by their IP address.

Location biasing increases relevance by automatically prioritising results near the user's current location

At a basic level this means that someone in the UK would find London first, whereas someone in Australia would see Sydney first. We use a unique combination of distance, relative importance and relevance to generate the best possible results and minimise the amount of searching required.

It's also possible to pass in a latitude, longitude to prioritise results near a specific point, rather than the user's approximate current location.

Result filtering

Result filtering can be used to limit searching to specific types of results.

Result filtering can be used to limit searching to specific types of results

Restrict searching to one category (e.g just cities), or any combination of categories (e.g. country names and states). Fine-grained control is available through the API.

The combination of restricting searching to specific types of results in certain countries, prioritised to near the user's location makes it possible to significantly improve the user experience when searching for places around the world.

What data is available in the Global Places API?

The service has worldwide coverage for:

Additionally, there is enhanced data available in certain countries:

Searching for streets in Canada with the Global Places API

All data includes coordinates, and we are currently preparing streets, postcodes and public transport data for other countries outside of Canada and Great Britain. Our aim is to expand enhanced datasets globally (subject to data availability).

How do I integrate the Global Places API?

The service can be integrated either using a ready-made JavaScript autocomplete integration, or directly through the API.

Full documentation for the Global Places API is now available, with code samples and guides to help you get started.

Try the demo

Try the interactive demo on the main Global Places API page, and see how location biasing and result filtering can be used to create a flexible location search tool.

New customers can create a free Swiftcomplete account for a 14 day free trial for developing with the API.

If you're an existing customer and would like to try the new service, let us know and we'll be happy to add some free trial credits to your account.

Questions & Feedback

If you have any questions, suggestions or feedback on the latest release, get in touch or start a live chat session when we're online.

For updates on our latest services, follow us on Twitter or LinkedIn.

More from the blog...