Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Saisie semi-automatique
Autocompleterenvoie des adresses complètes et des composants d'adresse sur la base d'une saisie partielle. Les principaux cas d'utilisation incluent le remplissage automatique du formulaire d'adresse et la saisie anticipée des adresses (saisie de l'adresse de manière interactive pendant que l'utilisateur final la saisit).
Note
Par défaut, seuls l'identifiant du lieu, le type de lieu et les attributs d'étiquette sont renvoyés pour chaque résultat. Il est possible d'obtenir de nombreux détails supplémentaires, notamment la répartition complète des adresses et les plages de surlignage des entrées pour les cas d'utilisation interactifs, en définissant l'attribut AdditionalFeatures d'entrée, mais notez que la demande de fonctionnalités supplémentaires peut avoir un impact Tarifs des places
Note
Les adresses japonaises ne sont pas prises en charge.
Les résultats sont toujours des adresses ou des composants d'adresse tels que les rues, les codes postaux et les pays. Les points d'intérêt ne sont jamais remboursés. Les résultats n'incluent pas les géocodes, car Autocomplete ils sont axés sur la complétion des adresses et non sur le géocodage. Pour obtenir les coordonnées de géocodage d'adresses, utilisez l'opération Geocode. Les résultats peuvent être filtrés par zone géographique. Ils peuvent également être filtrés par type de lieu, par exemple pour inclure uniquement les localités ou uniquement les codes postaux.
Pour plus de détails sur tous les attributs de demande et de réponse de saisie automatique, consultez la section de saisie semi-automatique dans le manuel Amazon Location Service API Reference.
Pour des exemples de requêtes, de réponses, de cURL et de commandes CLI pour cette API, consultez Comment utiliser la saisie semi-automatique.
Cas d’utilisation
-
Améliorez l'expérience de paiement : fournissez la saisie des adresses en temps réel lorsque les clients saisissent leur adresse dans le cadre des expériences de paiement en ligne et lors d'autres expériences de saisie d'adresses sur des sites Web ou des applications. Assurez-vous que les points de livraison ou de retrait correspondent aux adresses connues, afin de réduire les erreurs coûteuses et d'accroître la satisfaction des clients.
-
Support du service client : Proposez des suggestions d'adresses en temps réel aux représentants du service client dans des domaines tels que les centres d'appels et le déploiement des services d'urgence, en rationalisant le processus de collecte d'informations d'adresse précises et en améliorant la satisfaction des utilisateurs en réduisant le temps nécessaire pour obtenir des informations d'adresse correctes.
Comprendre la demande
L'Autocompleteopération prend en charge de nombreux attributs de demande facultatifs pour affiner les résultats de recherche. Pour obtenir la liste complète des attributs de demande, reportez-vous à la section Autocomplete du manuel Amazon Location Service API Reference.
La demande accepte les paramètres clés suivants :
- Authentification
-
L'opération d'API Autocomplete prend en charge deux modes d'authentification alternatifs. Vous pouvez vous authentifier soit en signant la demande avec une signature SigV4, soit en fournissant une clé d'API.
-
Si vous envoyez des demandes à l'aide d'un SDK AWS spécifique à une langue ou à l'aide de l'AWS CLI, votre demande sera normalement signée avec SigV4 par défaut.
-
Dans certains cas d'utilisation, par exemple lorsque vous effectuez des demandes depuis un navigateur Web ou que vous utilisez un autre client que le SDK AWS, les clés d'API constituent une forme d'authentification plus appropriée. Utilisez l'attribut facultatif de demande Key pour fournir une clé d'API pour vous authentifier auprès
Autocompletede.
Pour plus d'informations, consultez Authentifiez-vous auprès d'Amazon Location Service le manuel Amazon Location Service API Reference.
-
- Spécification de l'adresse à interroger
-
-
Utilisez l'attribut de
QueryTextdemande obligatoire pour fournir le texte libre à interroger. -
BiasPosition: utilisez l'attribut deBiasPositiondemande facultatif pour fournir une position d'épingle, sous forme de paire de[longitude, latitude]coordonnées, afin d'améliorer la pertinence des résultats renvoyés.
Pour plus d'informations, consultez Interrogation et biais le manuel Amazon Location Service API Reference.
-
- Inclure tous les attributs de réponse
-
Définissez le champ facultatif sur AdditionalFeatures la valeur ["Core"] pour inclure tous les attributs de résultat disponibles dans la réponse, y compris le détail complet des adresses et les points forts interactifs. Notez que le fait de demander ces attributs supplémentaires peut avoir un impact sur les prix
- Affiner les résultats
-
Utilisez l'attribut Filter pour filtrer les résultats renvoyés en fonction de pays, de types de lieux ou de zones géographiques spécifiques. Pour plus de détails, consultez Filtrage le manuel Amazon Location Service Developer Guide.
Comprendre la réponse
L'objet de réponse contient un attribut de tableau nommé ResultItems qui contient la liste des résultats classés par ordre croissant de pertinence. Pour obtenir la liste complète des attributs des articles obtenus, reportez-vous à la section Autocomplete du manuel Amazon Location Service API Reference.
Vous trouverez ci-dessous une courte liste de certains des attributs les plus importants des éléments de résultat.
- Adresse et informations connexes
-
-
PlaceTypecontient le type de lieu du résultat, qui nous indique si l'adresse représente une adresse ponctuelle, une rue, etc. Les résultats renvoyés parAutocompleteauront toujours un type de lieu qui représente soit une adresse complète, soit une composante d'une adresse, comme une rue ou un code postal. Les résultats n'incluront jamais de points d'intérêt. -
Addresscontient l'étiquette de résultat et, si cela["Core"]est spécifié pourAdditionalFeatures, il contient également la ventilation complète de l'adresse en champs structurés, y compris le numéro de maison, le nom de rue, le code postal, le pays, etc.
-
- Analyse des résultats
-
Fournit des données d'analyse pour chaque résultat par rapport à la requête d'entrée.
-
Distance: Si unBiasPositiona été fourni dans la demande, chaque élément de résultat contient unDistanceattribut indiquant la distance, en mètres, entre ce résultat et leBiasPosition. Nécessite la définition deAdditionalFeaturessur["Core"]. -
Highlightsindique où les mots, les phrases et les sous-chaînes de l'entréeQueryTextapparaissent exactement dans un attribut de résultat, ce qui permet aux applications de proposer des expériences utilisateur utiles qui mettent en évidence les correspondances pour leurs utilisateurs. Nécessite la définition deAdditionalFeaturessur["Core"].
-
