Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Autocompletar
`Autocomplete`devuelve direcciones completas y componentes de direcciones en función de una entrada parcial. Los casos de uso clave incluyen el llenado automático del formulario de direcciones y la escritura anticipada de direcciones (completar la dirección de forma interactiva mientras el usuario final la escribe).
**nota**
De forma predeterminada, solo se muestran el identificador del lugar, el tipo de lugar y los atributos de la etiqueta para cada resultado. Al configurar el atributo de entrada, se pueden obtener muchos detalles adicionales, como el desglose completo de las direcciones y los rangos de `AdditionalFeatures` entradas destacadas para casos de uso interactivo, pero tenga en cuenta que la solicitud de funciones adicionales puede afectar [Precios de lugares](places-pricing.md)
**nota**
No se admiten direcciones en japonés.
Los resultados son siempre direcciones o componentes de direcciones, como calles, códigos postales y países. Los puntos de interés nunca se devuelven. Los resultados no incluyen códigos geográficos, ya que `Autocomplete` se centran en completar las direcciones, no en la geocodificación. [Para obtener las coordenadas de geocodificación de direcciones, utilice la operación de geocodificación.](https://docs.aws.amazon.com/location/latest/developerguide/geocode.html) Los resultados se pueden filtrar por área geográfica. También se pueden filtrar por tipo de lugar, por ejemplo, para incluir solo las localidades o solo los códigos postales.
Para obtener más información sobre todos los atributos de solicitud y respuesta de Autocompletar, consulta [Autocompletar](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html) en la referencia de la *API de Amazon Location Service*.
Para ver ejemplos de solicitudes, respuestas, cURL y comandos de la CLI para esta API, consulte [Cómo usar Autocompletar](https://docs.aws.amazon.com/location/latest/developerguide/autocomplete-how-to.html).
## Casos de uso
+ **Mejora la experiencia de pago: permite** completar las direcciones en tiempo real a medida que los clientes introducen su dirección en las experiencias de pago de comercio electrónico y otras experiencias de introducción de direcciones en sitios web o aplicaciones. Asegúrese de que los lugares de entrega o recogida coincidan con las direcciones conocidas, reduciendo así los costosos errores y aumentando la satisfacción de los clientes.
+ **Support Customer Services:** Ofrezca sugerencias de direcciones en tiempo real a los representantes del servicio de atención al cliente en campos como los centros de contacto y el despacho de servicios de emergencia, agilizando el proceso de recopilación de información de dirección precisa y mejorando la satisfacción de los usuarios al reducir el tiempo necesario para obtener la información de dirección correcta.
## Explicación de la solicitud
La `Autocomplete` operación admite muchos atributos de solicitud opcionales para refinar los resultados de la búsqueda. Para ver la lista completa de los atributos de las solicitudes, consulta [Autocompletar](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html) en la *referencia de la API de Amazon Location Service*.
La solicitud acepta los parámetros clave siguientes:
**Autenticación**
La operación de la API de autocompletar admite dos modos de autenticación alternativos. [Puede autenticarse firmando la solicitud con una firma [SigV4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) o proporcionando una clave de API.](https://docs.aws.amazon.com/location/latest/developerguide/access.html)
+ Si realiza solicitudes mediante un SDK de AWS específico para un idioma o mediante la CLI de AWS, su solicitud normalmente se firmará con SigV4 de forma predeterminada.
+ En algunos casos de uso, por ejemplo, al realizar solicitudes desde un navegador web o utilizar algún otro cliente del SDK que no sea de AWS, las claves de API son una forma de autenticación más adecuada. Utilice el atributo de solicitud de clave opcional para proporcionar una clave de API con la que realizar la autenticación. `Autocomplete`
Para obtener más información, consulta [Autenticación con Amazon Location Service](access.md) la *referencia de la API de Amazon Location Service*.
**Especificar la dirección que se va a realizar la consulta**
+ Utilice el atributo de `QueryText` solicitud obligatorio para proporcionar el texto de formato libre que se va a realizar la consulta.
+ `BiasPosition`: Utilice el atributo de `BiasPosition` solicitud opcional para proporcionar la posición de un marcador, como un par de `[longitude, latitude]` coordenadas, a fin de mejorar la relevancia de los resultados devueltos.
Para obtener más información, consulta [Consultas y sesgos](places-querying-biasing.md) la *referencia de la API de Amazon Location Service*.
**Incluye todos los atributos de respuesta**
Defina el campo opcional AdditionalFeatures con el valor ["Básico"] para incluir todos los atributos de resultado disponibles en la respuesta, incluido el desglose completo de las direcciones y las ubicaciones resaltadas de forma interactiva. Ten en cuenta que solicitar estos atributos adicionales puede afectar a [los precios](https://aws.amazon.com/location/pricing/)
**Refina los resultados**
Usa el atributo Filtrar para filtrar los resultados devueltos en función de países, tipos de lugares o áreas geográficas específicos. Para obtener más información, consulta [Filtrado](places-filtering.md) la *Guía para desarrolladores de Amazon Location Service*.
## Explicación de la respuesta
El objeto de respuesta contiene un nombre de atributo de matriz `ResultItems` que contiene la lista de resultados clasificados en orden ascendente según su relevancia. Para ver la lista completa de los atributos de los elementos de resultados, consulta [Autocompletar](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html) en la *referencia de la API de Amazon Location Service*.
La siguiente es una breve lista de algunos de los atributos más importantes de los elementos de resultados.
**Dirección y detalles relacionados**
+ `PlaceType`contiene el tipo de lugar del resultado, que nos indica si la dirección representa una dirección de punto, una calle, etc. Los resultados devueltos por siempre `Autocomplete` tendrán un tipo de lugar que represente una dirección completa o un componente de una dirección, como una calle o un código postal. Los resultados nunca incluirán puntos de interés.
+ `Address`contiene la etiqueta del resultado y, si `["Core"]` se especifica`AdditionalFeatures`, también contiene el desglose completo de la dirección en campos estructurados que incluyen el número de la casa, el nombre de la calle, el código postal, el país y similares.
**Análisis de los resultados**
Proporciona datos de análisis para cada resultado en relación con la consulta de entrada.
+ `Distance`: Si en la solicitud `BiasPosition` se proporcionó un, cada elemento del resultado contiene un `Distance` atributo que indica la distancia, en metros, entre ese resultado y el`BiasPosition`. Es necesario que `AdditionalFeatures` se establezca en `["Core"]`.
+ `Highlights`muestra dónde `QueryText` aparecen exactamente las palabras, frases y subcadenas de la entrada en un atributo de resultado, lo que permite a las aplicaciones ofrecer experiencias de usuario útiles que destaquen las coincidencias para sus usuarios. Es necesario que `AdditionalFeatures` se establezca en `["Core"]`.