Clase PlaceAutocompleteElement
Clase google.maps.places.PlaceAutocompleteElement
- PlaceAutocompleteElement es una subclase
HTMLElement
que proporciona un componente de IU para la API de Places Autocomplete. Después de cargar la bibliotecaplaces
, se puede crear una entrada con la funcionalidad de autocompletado en HTML. Por ejemplo:<gmp-placeautocomplete ></gmp-placeautocomplete>
Elemento personalizado:
<gmp-placeautocomplete></gmp-placeautocomplete>
Esta clase extiende HTMLElement
.
Esta clase implementa PlaceAutocompleteElementOptions
.
Para acceder, llama a const {PlaceAutocompleteElement} = await google.maps.importLibrary("places")
. Consulta Bibliotecas de la API de Maps JavaScript.
Constructor | |
---|---|
PlaceAutocompleteElement |
PlaceAutocompleteElement(options) Parámetros:
|
Propiedades | |
---|---|
inputElement |
Tipo:
HTMLInputElement El elemento de entrada para el que se muestran las opciones de autocompletado. |
Heredado:
componentRestrictions ,
locationBias ,
locationRestriction ,
requestedLanguage ,
requestedRegion y
types
|
Métodos | |
---|---|
|
addEventListener(type, listener[, options]) Parámetros:
Valor que se muestra:
void Configura una función a la que se llamará cada vez que se entregue el evento especificado al destino. Consulta addEventListener |
|
removeEventListener(type, listener[, options]) Parámetros:
Valor que se muestra:
void Elimina del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener. |
PlaceAutocompleteElementOptions
Interfaz google.maps.places.PlaceAutocompleteElementOptions
Opciones para construir un PlaceAutocompleteElement.
Propiedades | |
---|---|
inputElement |
Tipo:
HTMLInputElement El elemento de entrada para el que se muestran las opciones de autocompletado. |
componentRestrictions optional |
Tipo:
ComponentRestrictions optional Las restricciones de componentes. Las restricciones de componentes se usan para restringir las predicciones solo a aquellas que están dentro del componente superior. Por ejemplo, el país. |
locationBias optional |
Tipo:
LocationBias optional Un límite flexible o una sugerencia que se puede usar para buscar lugares. |
locationRestriction optional |
Tipo:
LocationRestriction optional Límites para restringir los resultados de la búsqueda. |
requestedLanguage optional |
Tipo:
string optional Si es posible, un identificador de idioma para el idioma en el que se deben mostrar los resultados. Es posible que los resultados del idioma seleccionado tengan una clasificación más alta, pero las sugerencias no se restringen a este idioma. Consulta la lista de idiomas compatibles. |
requestedRegion optional |
Tipo:
string optional Es un código de región que se usa para dar formato a los resultados y filtrarlos. No restringe las sugerencias a este país. El código de región acepta un valor 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 los tipos. |
Clase PlaceAutocompletePlaceSelectEvent
Clase google.maps.places.PlaceAutocompletePlaceSelectEvent
Este evento se crea después de que el usuario selecciona un lugar con el elemento de Place Autocomplete. Accede a la selección con event.place
.
Esta clase extiende Event
.
Para acceder, llama a const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places")
. Consulta Bibliotecas de la API de Maps JavaScript.
Propiedades | |
---|---|
|
Tipo:
Place |
Clase PlaceAutocompleteRequestErrorEvent
Clase google.maps.places.PlaceAutocompleteRequestErrorEvent
PlaceAutocompleteElement emite este evento cuando hay un problema con la solicitud de red.
Esta clase extiende Event
.
Para acceder, llama a const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places")
. Consulta Bibliotecas de la API de Maps JavaScript.
Clase Autocomplete
Clase google.maps.places.Autocomplete
Es un widget que proporciona predicciones de Place basadas en la entrada de texto de un 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 el texto.
Esta clase extiende MVCObject
.
Para acceder, llama a const {Autocomplete} = await google.maps.importLibrary("places")
. Consulta Bibliotecas de 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 Son los límites de la personalización.Muestra los límites a los que se personalizan las predicciones. |
getFields |
getFields() Parámetros: Ninguno
Valor que se muestra:
Array<string>|undefined Muestra los campos que se incluirán en Place en la respuesta de detalles cuando estos se recuperen correctamente. Para obtener una lista de 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 estos se recuperaron correctamente. De lo contrario, muestra un objeto Place de stub, 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 Places. Los resultados se personalizan, aunque no de manera exclusiva, en esta área. |
setComponentRestrictions |
setComponentRestrictions(restrictions) Parámetros:
Valor que se muestra: ninguno
Establece las restricciones de componentes. Las restricciones de componentes se usan para restringir las predicciones solo a aquellas que están dentro del componente superior. Por ejemplo, el país. |
setFields |
setFields(fields) Parámetros:
Valor que se muestra: ninguno
Configura los campos que se incluirán en el lugar de la respuesta de detalles cuando estos se recuperen correctamente. Para obtener una lista de campos, consulta PlaceResult . |
setOptions |
setOptions(options) Parámetros:
Valor que se muestra: ninguno
|
setTypes |
setTypes(types) Parámetros:
Valor que se muestra: ninguno
Configura 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 los tipos. |
Heredado:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventos | |
---|---|
place_changed |
function() Argumentos: Ninguno
Este evento se activa cuando se habilita un PlaceResult para un lugar que el usuario seleccionó. Si el usuario ingresa el nombre de un lugar que el control no sugirió y presiona la tecla Intro, o bien, si falla una solicitud de Place Details, el objeto PlaceResult contiene la entrada del usuario en la propiedad name , sin otras propiedades definidas. |
AutocompleteOptions.
Interfaz google.maps.places.AutocompleteOptions
Opciones que se pueden configurar 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 de componentes. Las restricciones de componentes se usan para restringir las predicciones solo a aquellas que están dentro del componente superior. Por ejemplo, el país. |
fields optional |
Tipo:
Array<string> optional Campos que se incluirán en Place en la respuesta de detalles cuando estos se recuperen correctamente, que se facturará. 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 puntos (por ejemplo, "geometry.location" ). El valor predeterminado es ['ALL'] . |
|
Tipo:
boolean optional Indica si se deben recuperar solo los IDs de lugar. El PlaceResult disponible cuando se activa el evento place_changed solo tendrá los campos place_id, types y name, con el place_id, los tipos y la descripción que muestra el servicio de autocompletado. Están inhabilitados de forma predeterminada. |
strictBounds optional |
Tipo:
boolean optional Un valor booleano que indica que el widget de Autocomplete solo debe mostrar los lugares que están dentro de los límites del widget de Autocomplete en el momento en que se envía la consulta. Si estableces strictBounds en false (que es la opción predeterminada), los resultados se personalizarán según los lugares dentro de los límites, pero no se restringirán a ellos. |
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 los tipos. |
Clase SearchBox
Clase google.maps.places.SearchBox
Un widget que proporciona predicciones de consulta basadas en la entrada de texto de un 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 el texto.
Esta clase extiende MVCObject
.
Para acceder, llama a const {SearchBox} = await google.maps.importLibrary("places")
. Consulta Bibliotecas de 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 a los que se personalizan las predicciones de consulta. |
getPlaces |
getPlaces() Parámetros: Ninguno
Valor que se muestra:
Array<PlaceResult>|undefined Muestra la consulta seleccionada por el usuario que se usará con el evento places_changed . |
setBounds |
setBounds(bounds) Parámetros:
Valor que se muestra: ninguno
Configura la región que se usará para la personalización de las predicciones de consulta. Los resultados solo se restringirán a esta área y no se restringirán completamente a ella. |
Heredado:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventos | |
---|---|
places_changed |
function() Argumentos: Ninguno
Este evento se activa cuando el usuario selecciona una búsqueda. Se debe usar getPlaces para obtener lugares nuevos. |
SearchBoxOptions.
Interfaz google.maps.places.SearchBoxOptions
Opciones que se pueden configurar en un objeto SearchBox
.
Propiedades | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional El área hacia la cual sesgan las predicciones de consulta. Las predicciones se personalizan, aunque no de manera exclusiva, en función de estos límites. |