Comment aider les utilisateurs à désambiguïser des résultats similaires - Amazon Location Service

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.

Comment aider les utilisateurs à désambiguïser des résultats similaires

L'API Suggest vous permet de créer des requêtes pour des lieux ou des catégories de résultats. Les résultats sont triés selon les correspondances les plus probables et les moins probables. Des informations sont fournies pour chaque résultat afin de vous aider à identifier rapidement la bonne correspondance, notamment en ce qui concerne les champs Titre et Libellé.

Cas d'utilisation potentiels

  • Afficher les options de résultat : vous pouvez sélectionner l'option qui répond le mieux à vos besoins.

Exemples

Le champ Titre contient généralement suffisamment d'informations pour que vous sachiez quand le résultat correspond à ce qui était prévu. Dans les cas où le titre ne fournit pas suffisamment d'informations, le champ Label est utilisé pour ajouter le contexte des informations d'adresse au résultat. Le champ Label peut être fourni en tant que deuxième ligne d'informations, qui n'est pas soulignée dans le texte principal lorsque les résultats sont affichés pour vous. Dans l'exemple ci-dessous, deux résultats similaires sont fournis et l'adresse de l'hôtel peut vous aider à sélectionner celui qui correspond le mieux à vos besoins. De plus, la position est fournie afin que les résultats puissent être affichés sur une carte comme autre moyen de sélectionner entre les résultats.

Sample request
{ "QueryText": "Marriott", "Filter": { "IncludeCountries": [ "USA" ], "BoundingBox": [ -71.15693983012913,42.261623506672635, -70.97249727163558,42.37584075627763 ] }, "AdditionalFeatures": [ "Core" ] }
Sample response
{ "ResultItems": [ { "Title": "Marriott-Boston Cambridge", "SuggestResultItemType": "Place", "Place": { "PlaceId": "Redacted", "PlaceType": "PointOfInterest", "Address": { "Label": "Marriott-Boston Cambridge, 50 Broadway, Cambridge, MA 02138-4137, United States", "Country": { "Code2": "US", "Code3": "USA", "Name": "United States" }, "Region": { "Code": "MA", "Name": "Massachusetts" }, "SubRegion": { "Name": "Middlesex" }, "Locality": "Cambridge", "District": "MIT", "PostalCode": "02138-4137", "Street": "Broadway", "StreetComponents": [ { "BaseName": "Broadway", "Language": "en" } ], "AddressNumber": "50" }, "Position": [ -71.0858, 42.36294 ], "Distance": 5212, ... }, { "Title": "Marriott-Boston Copley Place", "SuggestResultItemType": "Place", "Place": { "PlaceId": "Redacted", "PlaceType": "PointOfInterest", "Address": { "Label": "Marriott-Boston Copley Place, 110 Huntington Ave, Boston, MA 02116-5706, United States", "Country": { "Code2": "US", "Code3": "USA", "Name": "United States" }, "Region": { "Code": "MA", "Name": "Massachusetts" }, "SubRegion": { "Name": "Suffolk" }, "Locality": "Boston", "District": "Back Bay", "PostalCode": "02116-5706", "Street": "Huntington Ave", "StreetComponents": [ { "BaseName": "Huntington", "Type": "Ave", "TypePlacement": "AfterBaseName", "TypeSeparator": " ", "Language": "en" } ], "AddressNumber": "110" }, "Position": [ -71.0792, 42.34701 ], "Distance": 3362, ... }, ... ], "QueryRefinements": [] }
cURL
curl --request POST \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/suggest?key=Your_Key' \ --header 'Content-Type: application/json' \ --data '{ "QueryText": "Marriott", "Filter": { "IncludeCountries": [ "USA" ], "BoundingBox": [ -71.15693983012913,42.261623506672635, -70.97249727163558,42.37584075627763 ] }, "AdditionalFeatures": [ "Core" ] }'
AWS CLI
aws geo-places suggest --key ${YourKey} \ --query-text "Marriott" \ --filter '{"IncludeCountries": ["USA"], "BoundingBox": [ -71.15693983012913,42.261623506672635, -70.97249727163558,42.37584075627763]}' \ --additional-features "Core"