Skip to content
This repository has been archived by the owner on Feb 2, 2023. It is now read-only.

algolia/places

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

header

Version Build Status License Downloads jsDelivr Hits

Deprecation of service

Places is going away on May 31st 2022. Read our blog post announcement. Places is going away on May 31st 2022. Read our blog post announcement. Places is going away on May 31st 2022. Read our blog post announcement. Places is going away on May 31st 2022. Read our blog post announcement. Places is going away on May 31st 2022. Read our blog post announcement. Places is going away on May 31st 2022. Read our blog post announcement.

Introduction

Algolia Places provides a fast, distributed and easy way to use an address search autocomplete JavaScript library on your website.

See the website for more information.

Read the blog post introducing Algolia Places.

Fill the Google form to report any irrelevant results.

Demo

Watch more examples on the website.

demo

Getting started

To use Algolia Places, all you need is an <input> and some JavaScript code that will load and use the places.js library.

CDN <script>

Our JavaScript library is available on the jsDelivr CDN and also on cdnjs.

<script src="https://cdn.jsdelivr.net/npm/places.js@1.19.0"></script>

Version is the latest version.

Here's a small example using it:

<input type="search" id="address-input" placeholder="Where are we going?" />

<script>
  var placesAutocomplete = places({
    appId: "<YOUR_PLACES_APP_ID>",
    apiKey: "<YOUR_PLACES_API_KEY>",
    container: document.querySelector('#address-input')
  });
</script>

Using npm

Algolia Places is also available on npm.

Install the module:

npm install places.js --save

Put an <input> in your html page:

<input type="search" id="address-input" placeholder="Where are we going?" />

Initialize the places.js library:

var places = require('places.js');
var placesAutocomplete = places({
  appId: "<YOUR_PLACES_APP_ID>",
  apiKey: "<YOUR_PLACES_API_KEY>",
  container: document.querySelector('#address-input')
});

Full documentation is available on the Algolia Places website.

Contributing

Wanna contribute? Awesome, please read the contributing guide.