Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/algolia/places
:globe_with_meridians: Turn any <input> into an address autocomplete
https://github.com/algolia/places
algolia autocomplete geo geocoder geolocation places
Last synced: 1 day ago
JSON representation
:globe_with_meridians: Turn any <input> into an address autocomplete
- Host: GitHub
- URL: https://github.com/algolia/places
- Owner: algolia
- License: mit
- Archived: true
- Created: 2016-03-22T09:01:46.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2023-02-02T08:40:26.000Z (almost 2 years ago)
- Last Synced: 2025-01-11T03:45:18.573Z (15 days ago)
- Topics: algolia, autocomplete, geo, geocoder, geolocation, places
- Language: JavaScript
- Homepage: https://community.algolia.com/places/
- Size: 11.4 MB
- Stars: 5,339
- Watchers: 133
- Forks: 230
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-discoveries - places - turn any HTML input form into an address autocomplete _(`JavaScript`)_ (Uncategorized)
- awesome - places - Turn any <input> into an address autocomplete, algolia service. (Services)
- awesome - places - Turn any <input> into an address autocomplete, algolia service. (Services)
README
[![header]][places-website]
[![Version][version-svg]][package-url] [![Build Status][travis-svg]][travis-url] [![License][license-image]][license-url] [![Downloads][downloads-image]][downloads-url] [![jsDelivr Hits][jsdelivr-badge]][jsdelivr-url]
## Deprecation of service
> Places is going away on May 31st 2022. [Read our blog post announcement.](https://www.algolia.com/blog/product/sunsetting-our-places-feature/)
> Places is going away on May 31st 2022. [Read our blog post announcement.](https://www.algolia.com/blog/product/sunsetting-our-places-feature/)
> Places is going away on May 31st 2022. [Read our blog post announcement.](https://www.algolia.com/blog/product/sunsetting-our-places-feature/)
> Places is going away on May 31st 2022. [Read our blog post announcement.](https://www.algolia.com/blog/product/sunsetting-our-places-feature/)
> Places is going away on May 31st 2022. [Read our blog post announcement.](https://www.algolia.com/blog/product/sunsetting-our-places-feature/)
> Places is going away on May 31st 2022. [Read our blog post announcement.](https://www.algolia.com/blog/product/sunsetting-our-places-feature/)
## Introduction
[Algolia Places][places-website] provides a fast, distributed and easy way to use an address search autocomplete JavaScript library on your website.
See the [website][places-website] for more information.
Read the [blog post](https://blog.algolia.com/introducing-algolia-places/) introducing Algolia Places.
Fill the [Google form](https://community.algolia.com/places/support.html#irrelevant-results) to report any irrelevant results.
## Demo
Watch [more examples on the website][places-website-examples].
[![demo]][places-website]
## Getting started
To use Algolia Places, all you need is an `` and some JavaScript code that will load
and use the places.js library.
### CDN ``
Our JavaScript library is available on the [jsDelivr CDN](http://www.jsdelivr.com) and also on [cdnjs](https://cdnjs.com/libraries/places.js).
```html
<script src="https://cdn.jsdelivr.net/npm/[email protected]">
```
[![Version][version-svg]][package-url] is the latest version.
Here's a small example using it:
```html
var placesAutocomplete = places({
appId: "<YOUR_PLACES_APP_ID>",
apiKey: "<YOUR_PLACES_API_KEY>",
container: document.querySelector('#address-input')
});
```
### Using npm
Algolia Places is also available on [npm](https://www.npmjs.com/package/places.js).
Install the module:
```sh
npm install places.js --save
```
Put an `` in your html page:
```html
```
Initialize the places.js library:
```js
var places = require('places.js');
var placesAutocomplete = places({
appId: "",
apiKey: "",
container: document.querySelector('#address-input')
});
```
Full documentation is available on the [Algolia Places website][places-website].
## Contributing
Wanna contribute? Awesome, please read the [contributing guide][contributing].
[demo]: ./demo.gif
[header]: ./header.png
[version-svg]: https://img.shields.io/npm/v/places.js.svg?style=flat-square
[package-url]: https://npmjs.org/package/places.js
[travis-svg]: https://img.shields.io/travis/algolia/places/master.svg?style=flat-square
[travis-url]: https://travis-ci.org/algolia/places
[license-image]: http://img.shields.io/badge/license-MIT-green.svg?style=flat-square
[license-url]: LICENSE
[downloads-image]: https://img.shields.io/npm/dm/places.js.svg?style=flat-square
[downloads-url]: http://npm-stat.com/charts.html?package=places.js
[places-website]: https://community.algolia.com/places/?utm_medium=social-owned&utm_source=GitHub&utm_campaign=places%20repository
[places-website-examples]: https://community.algolia.com/places/examples.html?utm_medium=social-owned&utm_source=GitHub&utm_campaign=places%20repository
[algolia-website]: https://www.algolia.com/?utm_medium=social-owned&utm_source=GitHub&utm_campaign=places%20repository
[places-docs]: https://community.algolia.com/places/documentation/?utm_medium=social-owned&utm_source=GitHub&utm_campaign=places%20repository
[contributing]: CONTRIBUTING.md
[jsdelivr-badge]: https://data.jsdelivr.com/v1/package/npm/places.js/badge
[jsdelivr-url]: https://www.jsdelivr.com/package/npm/places.js