PlaceAutocompleteElement
Clase google.maps.places.PlaceAutocompleteElement
Implementación de la API de AutocompleteView para Places
Esta clase implementa PlaceAutocompleteElementOptions
.
Para acceder, llama a const {PlaceAutocompleteElement} = await google.maps.importLibrary("places")
. Consulta Bibliotecas en la API de Maps JavaScript.
Constructor | |
---|---|
PlaceAutocompleteElement |
PlaceAutocompleteElement(options) Parámetros:
|
Propiedades | |
---|---|
element optional |
Tipo:
HTMLElement|SVGElement optional Este campo es de solo lectura. El elemento DOM que respalda la vista |
inputElement |
Tipo:
HTMLInputElement Elemento de entrada para el que se muestran datos de autocompletado. |
Heredada:
componentRestrictions ,
locationBias ,
locationRestriction ,
requestedLanguage ,
requestedRegion ,
types
|
Métodos | |
---|---|
addListener |
addListener(eventName, handler) Parámetros:
Valor que se muestra:
MapsEventListener Agrega la función de objeto de escucha determinada al nombre del evento determinado. |
Eventos | |
---|---|
gmp-placeselect |
function(place) Argumentos:
Este evento se activa cuando un usuario selecciona una predicción de lugar. Muestra un objeto de lugar. |
gmp-requesterror |
function() Argumentos: Ninguno
Este evento se activa cuando se rechaza una solicitud al backend (p.ej., una clave de API incorrecta). Este evento no aparece en burbuja. |
PlaceAutocompleteElementOptions.
Interfaz de google.maps.places.PlaceAutocompleteElementOptions
Opciones para construir un PlaceAutocompleteElement.
Propiedades | |
---|---|
inputElement |
Tipo:
HTMLInputElement Elemento de entrada para el que se muestran datos de autocompletado. |
componentRestrictions optional |
Tipo:
ComponentRestrictions optional 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. |
element optional |
Tipo:
HTMLElement|SVGElement optional Este campo es de solo lectura. El elemento DOM que respalda la vista |
locationBias optional |
Tipo:
LocationBias optional Sugerencia o límite flexible que se debe usar cuando se buscan lugares |
locationRestriction optional |
Tipo:
LocationRestriction optional Limita los resultados de la búsqueda. |
requestedLanguage optional |
Tipo:
string optional Un identificador de idioma para el idioma en el que se deben mostrar los resultados, si es posible. Es posible que los resultados en el idioma seleccionado tengan una clasificación más alta, pero las sugerencias no están restringidas para este idioma. Consulta la lista de idiomas compatibles. |
requestedRegion optional |
Tipo:
string optional Un código de región que se usa para el formato de resultados y el filtrado de resultados No restringe las sugerencias a este país. El código de la región acepta un valor de ccTLD ("dominio de nivel superior") de dos caracteres. La mayoría de los códigos ccTLD son idénticos a los códigos ISO 3166-1, con algunas excepciones notables. Por ejemplo, el ccTLD del Reino Unido es "uk" ( .co.uk ) mientras que su código ISO 3166-1 es "gb" (técnicamente para la entidad de "Reino Unido de Gran Bretaña e Irlanda del Norte"). |
types optional |
Tipo:
Array<string> optional Los tipos de predicciones que se mostrarán. Para conocer los tipos admitidos, consulta la guía para desarrolladores. Si no se especifican tipos, se mostrarán todos. |
Autocomplete
Clase google.maps.places.Autocomplete
Un widget que proporciona predicciones de Places según la entrada de texto del usuario. Se adjunta a un elemento de entrada de 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
.
Para acceder, llama a const {Autocomplete} = await google.maps.importLibrary("places")
. Consulta Bibliotecas en la API de Maps JavaScript.
Constructor | |
---|---|
Autocomplete |
Autocomplete(inputField[, opts]) Parámetros:
Crea una instancia nueva de Autocomplete que se adjunta al campo de texto de entrada especificado con las opciones determinadas. |
Métodos | |
---|---|
getBounds |
getBounds() Parámetros: Ninguno
Valor que se muestra:
LatLngBounds|undefined Los límites de la personalización.Muestra los límites para los que las predicciones están sesgadas. |
getFields |
getFields() Parámetros: Ninguno
Valor que se muestra:
Array<string>|undefined Muestra los campos que se deben incluir para el sitio en la respuesta de detalles cuando los detalles se recuperan correctamente. Para obtener una lista de los campos, consulta PlaceResult . |
getPlace |
getPlace() Parámetros: Ninguno
Valor que se muestra:
PlaceResult Es el lugar seleccionado por el usuario.Muestra los detalles del lugar seleccionado por el usuario si los detalles se recuperaron correctamente. De lo contrario, muestra un objeto stub de Place, 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 se deben mostrar los resultados de lugares. Los resultados se restringen, pero no se limitan a, esta área. |
setComponentRestrictions |
setComponentRestrictions(restrictions) Parámetros:
Valor que se muestra: Ninguno
Establece 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. |
setFields |
setFields(fields) Parámetros:
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 correctamente. Para obtener una lista de los campos, consulta PlaceResult . |
setOptions |
setOptions(options) Parámetros:
Valor que se muestra: Ninguno
|
setTypes |
setTypes(types) Parámetros:
Valor que se muestra: Ninguno
Establece los tipos de predicciones que se mostrarán. Para conocer los tipos admitidos, consulta la guía para desarrolladores. Si no se especifican tipos, se mostrarán todos. |
Heredada:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventos | |
---|---|
place_changed |
function() Argumentos: Ninguno
Este evento se activa cuando un PlaceResult está disponible para un lugar 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 falla una solicitud a Place Details, PlaceResult contiene la entrada del usuario en la propiedad name , sin otras propiedades definidas. |
AutocompleteOptions
Interfaz de google.maps.places.AutocompleteOptions
Las opciones que se pueden establecer en un objeto Autocomplete
.
Propiedades | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional El área en la que se buscarán lugares. |
componentRestrictions optional |
Tipo:
ComponentRestrictions optional 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. |
fields optional |
Tipo:
Array<string> optional Campos que se incluirán para el lugar en la respuesta a los detalles cuando estos 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 en implementaciones de producción). Para obtener una lista de los campos, consulta PlaceResult . Los campos anidados se pueden especificar con rutas de acceso de puntos (por ejemplo, "geometry.location" ). El valor predeterminado es ['ALL'] . |
|
Tipo:
boolean optional Indica si se deben recuperar solo IDs de lugar. El PlaceResult disponible cuando se activa el evento place_changed solo tendrá los campos place_id, type y name, y el servicio Autocomplete mostrará el place_id, los tipos y la descripción. Inhabilitada de forma predeterminada. |
strictBounds optional |
Tipo:
boolean optional Un valor booleano que indica que el widget de autocompletado solo debe mostrar los lugares 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 (configuración predeterminada), los resultados se restringirán, aunque no de manera exclusiva, a los lugares incluidos dentro de los límites. |
types optional |
Tipo:
Array<string> optional Los tipos de predicciones que se mostrarán. Para conocer los tipos admitidos, consulta la guía para desarrolladores. Si no se especifican tipos, se mostrarán todos. |
SearchBox
Clase google.maps.places.SearchBox
Un widget que proporciona predicciones de consultas basadas en la entrada de texto del usuario. Se adjunta a un elemento de entrada de 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
.
Para acceder, llama a const {SearchBox} = await google.maps.importLibrary("places")
. Consulta Bibliotecas en la API de Maps JavaScript.
Constructor | |
---|---|
SearchBox |
SearchBox(inputField[, opts]) Parámetros:
Crea una instancia nueva de SearchBox que se adjunta al campo de texto de entrada especificado con las opciones determinadas. |
Métodos | |
---|---|
getBounds |
getBounds() Parámetros: Ninguno
Valor que se muestra:
LatLngBounds|undefined Muestra los límites para los que las predicciones de consultas están sesgadas. |
getPlaces |
getPlaces() Parámetros: Ninguno
Valor que se muestra:
Array<PlaceResult>|undefined Muestra la consulta seleccionada por el usuario para usarla 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 consultas. Los resultados solo se restringirán a esta área y no se restringirán por completo a ella. |
Heredada:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventos | |
---|---|
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
.
Propiedades | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional El área hacia la que se pueden personalizar las predicciones de consulta. Las predicciones se restringen, aunque no de manera exclusiva, a consultas que se orientan a estos límites. |