Autocompletar

Autocompletedevuelve 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

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. 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 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.

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 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 o proporcionando una clave de API.

• 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 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 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

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 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 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

• PlaceTypecontiene 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.

• Addresscontiene la etiqueta del resultado y, si ["Core"] se especificaAdditionalFeatures, 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 elBiasPosition. Es necesario que AdditionalFeatures se establezca en ["Core"].

• Highlightsmuestra 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"].