Stay organized with collections Save and categorize content based on your preferences.
PlaceAutocompleteElement classgoogle.maps.places.PlaceAutocompleteElement
class
Notice: Available only in the v=beta channel.
PlaceAutocompleteElement is an HTMLElement
subclass which provides a UI component for the Places Autocomplete API.
Custom element:<gmp-place-autocomplete name="string" requested-language="string" requested-region="string" types="type1 type2 type3..."></gmp-place-autocomplete>
This class extends HTMLElement
.
This class implements PlaceAutocompleteElementOptions
.
Access by calling const {PlaceAutocompleteElement} = await google.maps.importLibrary("places")
. See Libraries in the Maps JavaScript API.
componentRestrictions
Type: ComponentRestrictions optional
The component restrictions. Component restrictions are used to restrict predictions to only those within the parent component. For example, the country.
locationBias
Type: LocationBias optional
A soft boundary or hint to use when searching for places.
locationRestriction
Type: LocationRestriction optional
Bounds to constrain search results.
name
Type: string optional
The name to be used for the input element. See
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#namefor details. Follows the same behavior as the name attribute for inputs. Note that this is the name that will be used when a form is submitted. See
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/formfor details.
HTML attribute:<gmp-placeautocomplete name="string"></gmp-placeautocomplete>
requestedLanguage
Type: string optional
A language identifier for the language in which the results should be returned, if possible. Results in the selected language may be given a higher ranking, but suggestions are not restricted to this language. See the
list of supported languages.
HTML attribute:<gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
Type: string optional
A region code which is used for result formatting and for result filtering. It does not restrict the suggestions to this country. The region code accepts a
ccTLD ("top-level domain")two-character value. Most ccTLD codes are identical to ISO 3166-1 codes, with some notable exceptions. For example, the United Kingdom's ccTLD is "uk" (
.co.uk
) while its ISO 3166-1 code is "gb" (technically for the entity of "The United Kingdom of Great Britain and Northern Ireland").
HTML attribute:<gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
types
Type: Array<string> optional
The types of predictions to be returned. For supported types, see the
developer's guide. If no types are specified, all types will be returned.
HTML attribute:<gmp-place-autocomplete types="type1 type2 type3..."></gmp-place-autocomplete>
prediction-item
An item in the drop down of predictions that represents a single prediction.
prediction-item-icon
The icon displayed to the left of each item in the list of predictions.
prediction-item-main-text
A part of prediction-item that is the main text of the prediction. For geographic locations, this contains a place name, like 'Sydney', or a street name and number, like '10 King Street'. By default, the prediction-item-main-text is colored black. If there is any additional text in the prediction-item, it is outside prediction-item-main-text and inherits its styling from prediction-item. It is colored gray by default. The additional text is typically an address.
prediction-item-match
The part of the returned prediction that matches the user’s input. By default, this matched text is highlighted in bold text. Note that the matched text may be anywhere within prediction-item. It is not necessarily part of prediction-item-main-text.
prediction-item-selected
The item when the user navigates to it via the keyboard. Note: Selected items will be affected by both this part styles and also the prediction-item part styles.
prediction-list
The visual element containing the list of predictions returned by the Place Autocomplete service. This list appears as a dropdown list below the PlaceAutocompleteElement.
MethodsaddEventListener
Notice: Available only in the v=beta channel.
addEventListener(type, listener[, options])
type
: string
A case-sensitive string representing the event type to listen for.listener
: EventListener|EventListenerObject
The object that receives a notification. This must be a function or an object with the handleEvent methodoptions
: boolean|AddEventListenerOptions optional
See options. Custom events only support capture
and passive
.Return Value: void
Sets up a function that will be called whenever the specified event is delivered to the target. See
addEventListenerremoveEventListener
Notice: Available only in the v=beta channel.
removeEventListener(type, listener[, options])
type
: string
A string which specifies the type of event for which to remove an event listener.listener
: EventListener|EventListenerObject
The event listener of the event handler to remove from the event target.options
: boolean|EventListenerOptions optional
See optionsReturn Value: void
Removes an event listener previously registered with addEventListener from the target. See
removeEventListener Eventsgmp-placeselect
function(placeAutocompletePlaceSelectEvent)
placeAutocompletePlaceSelectEvent
: PlaceAutocompletePlaceSelectEvent
This event is fired when a user selects a place prediction. Contains a Place object.
gmp-requesterror
function(placeAutocompleteRequestErrorEvent)
placeAutocompleteRequestErrorEvent
: PlaceAutocompleteRequestErrorEvent
This event is fired when a request to the backend was denied (e.g. incorrect API key). This event does not bubble.
PlaceAutocompletePlaceSelectEvent classgoogle.maps.places.PlaceAutocompletePlaceSelectEvent
class
Notice: Available only in the v=beta channel.
This event is created after the user selects a place with the Place Autocomplete Element. Access the selection with event.place
.
This class extends Event
.
Access by calling const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places")
. See Libraries in the Maps JavaScript API.
google.maps.places.PlaceAutocompleteRequestErrorEvent
class
Notice: Available only in the v=beta channel.
This event is emitted by the PlaceAutocompleteElement when there is an issue with the network request.
This class extends Event
.
Access by calling const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places")
. See Libraries in the Maps JavaScript API.
google.maps.places.Autocomplete
class
A widget that provides Place predictions based on a user's text input. It attaches to an input element of type text
, and listens for text entry in that field. The list of predictions is presented as a drop-down list, and is updated as text is entered.
This class extends MVCObject
.
Access by calling const {Autocomplete} = await google.maps.importLibrary("places")
. See Libraries in the Maps JavaScript API.
Autocomplete
Autocomplete(inputField[, opts])
inputField
: HTMLInputElement
The <input>
text field to which the Autocomplete
should be attached.opts
: AutocompleteOptions optional
Options.Creates a new instance of Autocomplete
that attaches to the specified input text field with the given options.
getBounds
getBounds()
Parameters: None
Return Value:LatLngBounds|undefined
The biasing bounds.
Returns the bounds to which predictions are biased.
getFields
getFields()
Parameters: None
Return Value:Array<string>|undefined
Returns the fields to be included for the Place in the details response when the details are successfully retrieved. For a list of fields see
PlaceResult
.
getPlace
getPlace()
Parameters: None
Return Value:PlaceResult
The Place selected by the user.
Returns the details of the Place selected by user if the details were successfully retrieved. Otherwise returns a stub Place object, with the name
property set to the current value of the input field.
setBounds
setBounds(bounds)
bounds
: LatLngBounds|LatLngBoundsLiteral optional
The biasing bounds.Return Value: None
Sets the preferred area within which to return Place results. Results are biased towards, but not restricted to, this area.
setComponentRestrictions
setComponentRestrictions(restrictions)
restrictions
: ComponentRestrictions optional
The restrictions to use.Return Value: None
Sets the component restrictions. Component restrictions are used to restrict predictions to only those within the parent component. For example, the country.
setFields
setFields(fields)
fields
: Array<string> optional
Return Value: None
Sets the fields to be included for the Place in the details response when the details are successfully retrieved. For a list of fields see
PlaceResult
.
setOptions
setOptions(options)
options
: AutocompleteOptions optional
Return Value: None
setTypes
setTypes(types)
types
: Array<string> optional
The types of predictions to be included.Return Value: None
Sets the types of predictions to be returned. For supported types, see the
developer's guide. If no types are specified, all types will be returned.
Inherited:addListener
, bindTo
, get
, notify
, set
, setValues
, unbind
, unbindAll
Events place_changed
function()
Arguments: None
This event is fired when a PlaceResult
is made available for a Place the user has selected.
If the user enters the name of a Place that was not suggested by the control and presses the Enter key, or if a Place Details request fails, the PlaceResult
contains the user input in the name
property, with no other properties defined.
google.maps.places.AutocompleteOptions
interface
The options that can be set on an Autocomplete
object.
bounds optional
Type: LatLngBounds|LatLngBoundsLiteral optional
The area in which to search for places.
componentRestrictions optional
Type: ComponentRestrictions optional
The component restrictions. Component restrictions are used to restrict predictions to only those within the parent component. For example, the country.
fields optional
Type: Array<string> optional
Fields to be included for the Place in the details response when the details are successfully retrieved,
which will be billed for. If
['ALL']
is passed in, all available fields will be returned and billed for (this is not recommended for production deployments). For a list of fields see
PlaceResult
. Nested fields can be specified with dot-paths (for example,
"geometry.location"
). The default is
['ALL']
.
placeIdOnlyoptional
Deprecated: placeIdOnly
is deprecated as of January 15, 2019, and will be turned off on January 15, 2020. Use AutocompleteOptions.fields
instead: fields: ['place_id', 'name', 'types']
.
Type: boolean optional
Whether to retrieve only Place IDs. The PlaceResult made available when the place_changed event is fired will only have the place_id, types and name fields, with the place_id, types and description returned by the Autocomplete service. Disabled by default.
strictBounds optional
Type: boolean optional
A boolean value, indicating that the Autocomplete widget should only return those places that are inside the bounds of the Autocomplete widget at the time the query is sent. Setting strictBounds to false
(which is the default) will make the results biased towards, but not restricted to, places contained within the bounds.
types optional
Type: Array<string> optional
The types of predictions to be returned. For supported types, see the
developer's guide. If no types are specified, all types will be returned.
SearchBox classgoogle.maps.places.SearchBox
class
A widget that provides query predictions based on a user's text input. It attaches to an input element of type text
, and listens for text entry in that field. The list of predictions is presented as a drop-down list, and is updated as text is entered.
This class extends MVCObject
.
Access by calling const {SearchBox} = await google.maps.importLibrary("places")
. See Libraries in the Maps JavaScript API.
SearchBox
SearchBox(inputField[, opts])
inputField
: HTMLInputElement
opts
: SearchBoxOptions optional
Creates a new instance of SearchBox
that attaches to the specified input text field with the given options.
places_changed
function()
Arguments: None
This event is fired when the user selects a query, getPlaces
should be used to get new places.
google.maps.places.SearchBoxOptions
interface
The options that can be set on a SearchBox
object.
bounds optional
Type: LatLngBounds|LatLngBoundsLiteral optional
The area towards which to bias query predictions. Predictions are biased towards, but not restricted to, queries targeting these bounds.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-14 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-14 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4