用于googleplacesAPI的React组件。_JavaScript_下载.zip

    [](https://GitHub.com/ErrorPro/react-google-autocomplete/master/LICENSE) ## The package provides 3 tools for working with google places services: 1. [ReactGoogleAutocomplete](#reactgoogleautocomplete) is a simple html input component that provides functionality of the [google places widgets](https://developers.google.com/maps/documentation/javascript/reference/places-widget#AutocompleteOptions). 2. [usePlacesWidget](#useplaceswidget) is a react hook that provides the same functionality as `ReactGoogleAutocomplete` does but it does not create any dom elements. Instead, it gives you back a react ref which you can set to any input you want. 3. [usePlacesAutocompleteService](#useplacesautocompleteservice) is a more complex react hook. It uses [google places autocomplete service](https://developers.google.com/maps/documentation/javascript/reference/places-autocomplete-service) and it provides all the functionality to you as the returned value. In addition to that, you can set a `debounce` prop which will reduce the amount of requests users send to Google. If you find this package helpful please give it a star because it hepls it grow and motivates us to build new features and support the old ones. ## Install `npm i react-google-autocomplete --save` or `yarn add react-google-autocomplete` <hr> As of version 1.2.4, you can now pass an `apiKey` prop to automatically load the Google maps scripts. The api key can be found in your [google cloud console.](https://developers.google.com/maps/documentation/javascript/get-api-key) ```js <Autocomplete apiKey={YOUR_GOOGLE_MAPS_API_KEY} onPlaceSelected={(place) => console.log(place)} /> or const { ref } = usePlacesWidget({ apiKey: YOUR_GOOGLE_MAPS_API_KEY, onPlaceSelected: (place) => console.log(place) }) <AnyInput ref={ref} /> ``` Alternatively if not passing the `apiKey` prop, you can include google autocomplete link api in your app. Somewhere in index.html or somewhere else. More info [here](https://developers.google.com/maps/documentation/places/web-service/autocomplete) ```html <script type="text/javascript" src="https://maps.googleapis.com/maps/api/js?key=[YOUR_API_KEY]&libraries=places" ></script> ``` ## ReactGoogleAutocomplete This is a simple react component for working with google [autocomplete](https://developers.google.com/maps/documentation/javascript/examples/places-autocomplete) ```js import Autocomplete from "react-google-autocomplete"; <Autocomplete apiKey={YOUR_GOOGLE_MAPS_API_KEY} onPlaceSelected={(place) => { console.log(place); }} />; ``` ### Props - `apiKey`: pass to automatically load the Google maps scripts. The api key can be found in your [google cloud console.](https://developers.google.com/maps/documentation/javascript/get-api-key) - `ref`: [React ref](https://reactjs.org/docs/hooks-reference.html#useref) to be assigned the underlying text input ref. - `onPlaceSelected: (place: `[PlaceResult](https://developers.google.com/maps/documentation/javascript/reference/places-service#PlaceResult)`, inputRef, `[autocompleteRef](https://developers.google.com/maps/documentation/javascript/reference/places-widget#Autocomplete)`) => void`: The function gets invoked every time a user chooses location. - `options`: [Google autocomplete options.](https://developers.google.com/maps/documentation/javascript/reference/places-widget#AutocompleteOptions) - `options.types`: By default it uses (cities). - `options.fields`: By default it uses `address_components`, `geometry.location`, `place_id`, `formatted_address`. - `inputAutocompleteValue`: Autocomplete value to be set to the underlying input. - `googleMapsScriptBaseUrl`: Provide custom google maps url. By default `https://maps.googleapis.com/maps/api/js` - `defaultValue` prop is used for setting up the default value e.g `defaultValue={'Amsterdam'}`. - `language`: Set [language](https://developers.google.com/maps/documentation/places/web-service/details#PlaceDetailsRequests) to be used for the results. If not specified, Google defaults to load the most appropriate language based on the users location or browser setting. - `libraries`: prop is used for loading additional google libraries alongside the places api, `defaultValue={["places"]}`. You can pass any prop specified for the hmtl [input tag](https://www.w3schools.com/tags/tag_input.asp). You can also set [options.fields](https://developers.google.com/maps/documentation/javascript/reference/places-service#PlaceResult) prop if you need extra information, now it defaults to basic data in order to control expenses. ## usePlacesWidget   Is a hook that has a single config argument. It has exactly the same interface as ReactGoogleAutocomplete props. This hook is actually used in the ReactGoogleAutocomplete component. ```js import { usePlacesWidget } from "react-google-autocomplete"; export default () => { const { ref, autocompleteRef } = usePlacesWidget({ apiKey:YOUR_GOOGLE_MAPS_API_KEY, onPlaceSelected: (place) => { console.log(place); } }); return <AnyInput ref={ref} {...anyOtherProp}> } ``` ### Arguments It has only one config argument which has propperties: `apiKey`, `ref`, `onPlaceSelected`, `options`, `inputAutocompleteValue`, `googleMapsScriptBaseUrl`. The same props described [here](#reactgoogleautocomplete) ### Returned value This hook returns object with only two properties: - `ref` - is a react ref which you can assign to any input you would like. - `autocompleteRef` - is the [autocomplete](https://developers.google.com/maps/documentation/javascript/reference/places-widget#Autocomplete) instance ## usePlacesAutocompleteService   This is an initial implementation of debounced google places autocomplete service. It gives you an option to reduce the amount of requests sent to google which reduce your costs. For the time being we decided to use `lodash.debounce` to save time and in the later versions we might write our own implementation of debounce with hooks. Because it uses lodash we also decided to not put it into the index library file so it lives in its own file and could be only imported by it. ```js import usePlacesService from "react-google-autocomplete/lib/usePlacesAutocompleteService"; export default () => { const { placesService, placePredictions, getPlacePredictions, isPlacePredictionsLoading, } = usePlacesService({ apiKey: process.env.REACT_APP_GOOGLE, }); useEffect(() => { // fetch place details for the first element in placePredictions array if (placePredictions.length) placesService?.getDetails( { placeId: placePredictions[0].place_id, }, (placeDetails) => savePlaceDetailsToState(placeDetails) ); }, [placePredictions]); return ( <> <Input placeholder="Debounce 500 ms" onChange={(evt) => { getPlacePredictions({ input: evt.target.value }); }} loading={isPlacePredictionsLoading} /> {placePredictions.map((item) => rend