Comment compléter une adresse

L'API Autocomplete vous permet de compléter des adresses partiellement saisies, de fournir une saisie standardisée aux utilisateurs finaux et d'améliorer l'efficacité lors de la saisie des données.

Cas d'utilisation potentiels

• Renseignez une adresse lors du paiement : Facilitez la saisie précise et rapide des adresses lorsque les clients saisissent un formulaire de commande.

• Complétion des adresses spécifiques au pays : limitez les suggestions à un pays spécifique pour des raisons de conformité ou de pertinence par rapport à la situation géographique de l'utilisateur.

Exemples

Adresse complète avec un minimum de données

Dans cet exemple, un minimum de données est renvoyé pour que la réponse soit concise et rentable. Les détails complets du lieu peuvent être récupérés ultérieurement à l' PlaceId aide de l' GetPlace API.

Sample request

{
  "QueryText": "100 McCullum Rd"
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "United Kingdom, E3 5JB, London, 100 McCullum Road"
        }
    ],
    "QueryRefinements": []
}

cURL

curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/autocomplete?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
  "QueryText": "100 McCullum Rd"
}'

AWS CLI

aws geo-places autocomplete --key ${YourKey} --query-text "100 McCullum Rd"

Adresse complète avec composant d'adresse

Cet exemple renvoie plusieurs suggestions d'adresses, permettant aux utilisateurs de sélectionner un format d'adresse standardisé pour remplir les champs de formulaire avec précision.

Sample request

{
  "QueryText": "100 McCullum Rd",
  "AdditionalFeatures": [
    "Core"
  ]
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "United Kingdom, E3 5JB, London, 100 McCullum Road",
            "Address": {
                "Label": "100 McCullum Road, London, E3 5JB, United Kingdom",
                "Country": {
                    "Code2": "GB",
                    "Code3": "GBR",
                    "Name": "United Kingdom"
                },
                "Region": {
                    "Name": "England"
                },
                "SubRegion": {
                    "Code": "LDN",
                    "Name": "London"
                },
                "Locality": "London",
                "District": "Bow",
                "PostalCode": "E3 5JB",
                "Street": "McCullum Road",
                "StreetComponents": [
                    {
                        "BaseName": "McCullum",
                        "Type": "Road",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": " ",
                        "Language": "en"
                    }
                ],
                "AddressNumber": "100"
            },
            "Language": "en",
            "Highlights": {
                "Title": [
                    {
                        "StartIndex": 32,
                        "EndIndex": 35,
                        "Value": "100"
                    },
                    {
                        "StartIndex": 36,
                        "EndIndex": 49,
                        "Value": "McCullum Road"
                    }
                ],
                "Address": {
                    "Label": [
                        {
                            "StartIndex": 0,
                            "EndIndex": 3,
                            "Value": "100"
                        },
                        {
                            "StartIndex": 4,
                            "EndIndex": 17,
                            "Value": "McCullum Road"
                        }
                    ],
                    "Street": [
                        {
                            "StartIndex": 0,
                            "EndIndex": 13,
                            "Value": "McCullum Road"
                        }
                    ],
                    "AddressNumber": [
                        {
                            "StartIndex": 0,
                            "EndIndex": 3,
                            "Value": "100"
                        }
                    ]
                }
            }
        },
        ...
    ],
    "QueryRefinements": []
}

cURL

curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/autocomplete?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
  "QueryText": "100 McCullum Rd",
  "AdditionalFeatures": [
    "Core"
  ]
}'

AWS CLI

aws geo-places autocomplete --key ${YourKey} --query-text "100 McCullum Rd" --additional-features "Core"