Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -201,6 +201,10 @@ Reference
search is to be restricted. The maximum is 50000 meters.
(default 3200)

strictbounds -- Returns only those places that are strictly within the region defined by
location and radius. This is a restriction, rather than a bias, meaning that
results outside this region will not be returned even if they match the user input

language -- The language code, indicating in which language the
results should be returned, if possible. (default lang.ENGLISH)

Expand Down
45 changes: 25 additions & 20 deletions googleplaces/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -354,39 +354,44 @@ def text_search(self, query=None, language=lang.ENGLISH, lat_lng=None,
return GooglePlacesSearchResult(self, places_response)

def autocomplete(self, input, lat_lng=None, location=None, radius=3200,
language=lang.ENGLISH, types=None, components=[]):
language=lang.ENGLISH, types=None, components=[], strictbounds=None):
"""
Perform an autocomplete search using the Google Places API.

Only the input kwarg is required, the rest of the keyword arguments
are optional.

keyword arguments:
input -- The text string on which to search, for example:
"Hattie B's".
lat_lng -- A dict containing the following keys: lat, lng
(default None)
location -- A human readable location, e.g 'London, England'
(default None)
radius -- The radius (in meters) around the location to which the
search is to be restricted. The maximum is 50000 meters.
(default 3200)
language -- The language code, indicating in which language the
results should be returned, if possible. (default lang.ENGLISH)
types -- A type to search against. See `types.py` "autocomplete types"
for complete list
https://developers.google.com/places/documentation/autocomplete#place_types.
components -- An optional grouping of places to which you would
like to restrict your results. An array containing one or
more tuples of:
* country: matches a country name or a two letter ISO 3166-1 country code.
eg: [('country','US')]
input -- The text string on which to search, for example:
"Hattie B's".
lat_lng -- A dict containing the following keys: lat, lng
(default None)
location -- A human readable location, e.g 'London, England'
(default None)
radius -- The radius (in meters) around the location to which the
search is to be restricted. The maximum is 50000 meters.
(default 3200)
strictbounds -- Returns only those places that are strictly within the region defined by
location and radius. This is a restriction, rather than a bias, meaning that
results outside this region will not be returned even if they match the user input
language -- The language code, indicating in which language the
results should be returned, if possible. (default lang.ENGLISH)
types -- A type to search against. See `types.py` "autocomplete types"
for complete list
https://developers.google.com/places/documentation/autocomplete#place_types.
components -- An optional grouping of places to which you would
like to restrict your results. An array containing one or
more tuples of:
* country: matches a country name or a two letter ISO 3166-1 country code.
eg: [('country','US')]
"""
self._request_params = {'input': input}
if lat_lng is not None or location is not None:
lat_lng_str = self._generate_lat_lng_string(lat_lng, location)
self._request_params['location'] = lat_lng_str
self._request_params['radius'] = radius
if strictbounds:
self._request_params['strictbounds'] = 'true'
if types:
self._request_params['types'] = types
if len(components) > 0:
Expand Down