Places Widgets

Clase Autocomplete

Clase google.maps.places.Autocomplete

Un widget que proporciona predicciones de lugar según la entrada de texto del usuario. Se adjunta a un elemento de entrada del tipo text y escucha la entrada de texto en ese campo. La lista de predicciones se presenta como una lista desplegable y se actualiza a medida que se ingresa texto.

Esta clase extiende MVCObject.

Carga con el parámetro de URL &libraries=places. Consulta Bibliotecas en la API de Maps JavaScript.

Cuando se usa v=beta, se puede acceder a él llamando a const {Autocomplete} = await google.map.importLibrary("places"). Consulta Bibliotecas en la API de Maps JavaScript.
Autocomplete
Autocomplete(inputField[, opts])
Parámetros:
Crea una instancia nueva de Autocomplete que se adjunte al campo de texto de entrada especificado con las opciones determinadas.
getBounds
getBounds()
Parámetros: ninguno
Valor que se muestra: LatLngBounds|undefined Los límites de la personalización.
Devuelve los límites a los que las predicciones están sesgadas.
getFields
getFields()
Parámetros: ninguno
Valor que se muestra: Array<string>|undefined
Muestra los campos que se incluirán para el sitio en la respuesta de detalles cuando los detalles se recuperan correctamente. Para obtener una lista de campos, consulta PlaceResult.
getPlace
getPlace()
Parámetros: ninguno
Valor que se muestra: PlaceResult El lugar seleccionado por el usuario.
Muestra los detalles del sitio seleccionado por el usuario si estos se recuperaron correctamente. De lo contrario, muestra un objeto auxiliar de lugar, con la propiedad name establecida en el valor actual del campo de entrada.
setBounds
setBounds(bounds)
Parámetros:
Valor que se muestra: Ninguno
Establece el área preferida dentro de la cual mostrar resultados de lugar. Los resultados están restringidos a esta área, pero no se limitan a ella.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parámetros:
Valor que se muestra: Ninguno
Establece las restricciones del componente. Las restricciones de componentes se usan para restringir las predicciones a solo aquellas incluidas en el componente superior. Por ejemplo, el país.
setFields
setFields(fields)
Parámetros:
  • fields: Array<string> optional
Valor que se muestra: Ninguno
Establece los campos que se incluirán para el lugar en la respuesta de detalles cuando los detalles se recuperan con éxito. Para obtener una lista de campos, consulta PlaceResult.
setOptions
setOptions(options)
Parámetros:
Valor que se muestra: Ninguno
setTypes
setTypes(types)
Parámetros:
  • types: Array<string> optional Los tipos de predicciones que se incluirán.
Valor que se muestra: Ninguno
Establece los tipos de predicciones que se mostrarán. Para obtener información sobre los tipos compatibles, consulta la Guía para desarrolladores. Si no se especifican tipos, se mostrarán todos.
Heredada: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Argumentos: Ninguno
Este evento se activa cuando un PlaceResult está disponible para un sitio que el usuario seleccionó.
Si el usuario ingresa el nombre de un lugar que no fue sugerido por el control y presiona la tecla Intro, o si una solicitud de Place Details falla, PlaceResult contiene la entrada del usuario en la propiedad name, sin ninguna otra propiedad definida.

AutocompleteOptions.

Interfaz de google.maps.places.AutocompleteOptions

Las opciones que se pueden establecer en un objeto Autocomplete.

Carga con el parámetro de URL &libraries=places. Consulta Bibliotecas en la API de Maps JavaScript.
bounds optional
El área en la que se buscan lugares.
componentRestrictions optional
Tipo: ComponentRestrictions optional
Las restricciones de los componentes. Las restricciones de componentes se usan para restringir las predicciones a solo aquellas incluidas en el componente superior. Por ejemplo, el país.
fields optional
Tipo: Array<string> optional
Los campos que se incluirán en el sitio de la respuesta de detalles cuando los detalles se recuperen correctamente, que se facturarán. Si se pasa ['ALL'], se mostrarán y facturarán todos los campos disponibles (esto no se recomienda para implementaciones de producción). Para obtener una lista de campos, consulta PlaceResult. Los campos anidados se pueden especificar con rutas de acceso de puntos (por ejemplo, "geometry.location"). El valor predeterminado es ['ALL'].
placeIdOnly optional
Tipo: boolean optional
Indica si solo se deben recuperar los ID de lugar. El PlaceResult disponible cuando se active el evento place_changed solo incluirá los campos place_id, tipos y nombre, con el place_id, los tipos y la descripción que muestra el servicio de autocompletado. Inhabilitada de forma predeterminada.
strictBounds optional
Tipo: boolean optional
Un valor booleano que indica que el widget de autocompletado solo debe mostrar los sitios que están dentro de los límites del widget de autocompletado en el momento en que se envía la consulta. Si estableces strictBounds en false (que es la opción predeterminada), los resultados se restringirán, pero no se restringirán, a los lugares dentro de los límites.
types optional
Tipo: Array<string> optional
Los tipos de predicciones que se mostrarán. Para obtener información sobre los tipos compatibles, consulta la Guía para desarrolladores. Si no se especifican tipos, se mostrarán todos.

Clase google.maps.places.SearchBox

Un widget que proporciona predicciones de consulta basadas en la entrada de texto del usuario. Se adjunta a un elemento de entrada del tipo text y escucha la entrada de texto en ese campo. La lista de predicciones se presenta como una lista desplegable y se actualiza a medida que se ingresa texto.

Esta clase extiende MVCObject.

Carga con el parámetro de URL &libraries=places. Consulta Bibliotecas en la API de Maps JavaScript.

Cuando se usa v=beta, se puede acceder a él llamando a const {SearchBox} = await google.map.importLibrary("places"). Consulta Bibliotecas en la API de Maps JavaScript.
SearchBox
SearchBox(inputField[, opts])
Parámetros:
Crea una instancia nueva de SearchBox que se adjunte al campo de texto de entrada especificado con las opciones determinadas.
getBounds
getBounds()
Parámetros: ninguno
Valor que se muestra: LatLngBounds|undefined
Muestra los límites a los que las predicciones de consulta están sesgadas.
getPlaces
getPlaces()
Parámetros: ninguno
Valor que se muestra: Array<PlaceResult>|undefined
Muestra la consulta seleccionada por el usuario para usar con el evento places_changed.
setBounds
setBounds(bounds)
Parámetros:
Valor que se muestra: Ninguno
Establece la región que se usará para personalizar las predicciones de consulta. Los resultados estarán restringidos únicamente a esta área y no se restringirán por completo a ella.
Heredada: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Argumentos: Ninguno
Este evento se activa cuando el usuario selecciona una consulta. Se debe usar getPlaces para obtener lugares nuevos.

SearchBoxOptions

Interfaz de google.maps.places.SearchBoxOptions

Las opciones que se pueden establecer en un objeto SearchBox.

Carga con el parámetro de URL &libraries=places. Consulta Bibliotecas en la API de Maps JavaScript.
bounds optional
El área hacia la cual se pueden sesgar las predicciones de consulta. Las predicciones están sesgadas, pero no se limitan a, a consultas que se orientan a estos límites.