Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/generalpiston/react-autosuggest-geocoder
react-autosuggest with suggestions from pelias services, such as geocode.earth.
https://github.com/generalpiston/react-autosuggest-geocoder
address address-autocomplete autocomplete autosuggest demo geocode-earth mapzen pelias react react-component
Last synced: about 2 months ago
JSON representation
react-autosuggest with suggestions from pelias services, such as geocode.earth.
- Host: GitHub
- URL: https://github.com/generalpiston/react-autosuggest-geocoder
- Owner: generalpiston
- License: bsd-3-clause
- Created: 2016-12-31T20:06:58.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-04-28T08:24:29.000Z (over 1 year ago)
- Last Synced: 2024-07-25T14:26:04.542Z (2 months ago)
- Topics: address, address-autocomplete, autocomplete, autosuggest, demo, geocode-earth, mapzen, pelias, react, react-component
- Language: JavaScript
- Homepage: https://abec.github.io/react-autosuggest-geocoder/
- Size: 6.26 MB
- Stars: 15
- Watchers: 3
- Forks: 5
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# react-autosuggest-geocoder
[react-autosuggest](https://github.com/moroshko/react-autosuggest) with suggestions from [pelias](https://github.com/pelias/pelias) services. Click [here](http://generalpiston.github.io/react-autosuggest-geocoder) to try it out.
Thank you to the team at [https://geocode.earth](https://geocode.earth) for lending a pelias service for the demo!
## Setup / Usage
### 1. Install react-autosuggest-geocoder
Through NPM:
```
npm install --save react-autosuggest-geocoder
```
Through Yarn:
```
yarn add react-autosuggest-geocoder
```
### 2. Create a react component that wraps react-autosuggest-geocoder
```
import { ReactAutosuggestGeocoder } from 'react-autosuggest-geocoder'
class SearchPage extends React.Component {
constructor(props) {
super(props);
this.state = {
search: "",
latitude: Infinity,
longitude: Infinity
};
}
render() {
return (
{
this.setState({
location: suggestion.properties.label,
latitude: suggestion.geometry.coordinates[1],
longitude: suggestion.geometry.coordinates[0]
})
}} />
);
}
}
```
## Props
| Prop | Type | Required | Default | Description |
| :--- | :--- | :---: | :--- | :--- |
| url | string | ✓ | https://api.geocode.earth/v1 | |
| apiKey | string | ✓ | | Pelias service API key. Most useful with geocode.earth. See https://geocode.earth/ to get an API key. |
| sources | string | ✓ | openaddresses | Filter data by data source. |
| fetchDelay | number | ✓ | 150 | Debounce API requests with this delay (in milliseconds). |
| center | object | | | Orient search results towards the provided center. |
| bounds | array | | | Bounding box to limit search results. |
| onSuggestionSelected | function | | | See https://github.com/moroshko/react-autosuggest#onSuggestionSelectedProp for details. |
| onReverseSelected | function | | | Invoked after reverse geocoding is performed. |
| getSuggestionValue | function | ✓ | Identity Function | See https://github.com/moroshko/react-autosuggest#getsuggestionvalue-required for details. |
| renderSuggestion | function | ✓ | Div Wrapper Function | See https://github.com/moroshko/react-autosuggest#rendersuggestion-required for details. |
| fetch | function | | `fetch` (from `node-fetch`) | Make the HTTP requests with this custom function
## Ref Methods
### reverseGeocode({ latitude, longitude })
Reverse geocode the given point into the component input text field.
### update(newValue)
Update the autocomplete input text field.
### clear()
Clear the autocomplete input text field and deselect any previously selected values.
### focus()
Bring browser focus to the autocomplete input text field.
### blur()
Unfocus browser from the autocomplete input text field.
## License
BSD-3
## Special Thanks
To the folks at https://geocode.earth for their continued work on Pelias.