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 contrôler les variantes de noms d'adresses
<a name="how-to-geocode-address-names-mode"></a>

`AddressNamesMode`indique comment les noms d'adresses sont renvoyés. S'il n'est pas défini, le service renvoie des noms normalisés (officiels) par défaut. Lorsque cette valeur est définie sur`Matched`, les noms d'adresse figurant dans la réponse sont basés sur la requête d'entrée plutôt que sur des noms officiels. Lorsqu'il est défini sur`Administrative`, le service renvoie les noms administratifs officiels des composants d'adresse. `Administrative`s'applique actuellement uniquement aux adresses situées aux États-Unis d'Amérique.

## Cas d'utilisation potentiels
<a name="geocode-address-names-mode-use"></a>
+ Remplissage **du formulaire d'adresse :** `Matched` à utiliser pour renvoyer des noms conformes à ce que l'utilisateur a saisi, afin de réduire la confusion dans les flux de travail de saisie automatique.
+ **Standardisation des adresses :** `Administrative` à utiliser pour normaliser les noms de villes par rapport à leur forme administrative officielle pour garantir la qualité des données et la déduplication.

## Exemples
<a name="geocode-address-names-mode-example"></a>

### Utiliser le mode Matched
<a name="geocode-address-names-mode-matched"></a>

------
#### [ Sample request ]

```
{
    "QueryText": "100 Universal City Plaza, Hollywood, CA",
    "AddressNamesMode": "Matched"
}
```

------
#### [ Sample response ]

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "100 Universal City Plz, Universal City, CA 91608, United States",
            "Address": {
                "Label": "100 Universal City Plz, Universal City, CA 91608, United States",
                "Country": {
                    "Code2": "US",
                    "Code3": "USA",
                    "Name": "United States"
                },
                "Region": {
                    "Code": "CA",
                    "Name": "California"
                },
                "Locality": "Universal City",
                "PostalCode": "91608",
                "Street": "Universal City Plz",
                "AddressNumber": "100"
            },
            "Position": [
                -118.36054,
                34.13857
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryText": "100 Universal City Plaza, Hollywood, CA",
    "AddressNamesMode": "Matched"
}'
```

------
#### [ AWS CLI ]

```
aws geo-places geocode --key ${YourKey} --query-text "100 Universal City Plaza, Hollywood, CA" --address-names-mode Matched
```

------

### Utiliser le mode administratif
<a name="geocode-address-names-mode-administrative"></a>

------
#### [ Sample request ]

```
{
    "QueryText": "100 Universal City Plaza, Hollywood, CA",
    "AddressNamesMode": "Administrative"
}
```

------
#### [ Sample response ]

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "100 Universal Terrace Pkwy, Los Angeles, CA 91608, United States",
            "Address": {
                "Label": "100 Universal Terrace Pkwy, Los Angeles, CA 91608, United States",
                "Country": {
                    "Code2": "US",
                    "Code3": "USA",
                    "Name": "United States"
                },
                "Region": {
                    "Code": "CA",
                    "Name": "California"
                },
                "Locality": "Los Angeles",
                "PostalCode": "91608",
                "Street": "Universal Terrace Pkwy",
                "AddressNumber": "100"
            },
            "Position": [
                -118.36054,
                34.13857
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryText": "100 Universal City Plaza, Hollywood, CA",
    "AddressNamesMode": "Administrative"
}'
```

------
#### [ AWS CLI ]

```
aws geo-places geocode --key ${YourKey} --query-text "100 Universal City Plaza, Hollywood, CA" --address-names-mode Administrative
```

------

## Conseils aux développeurs
<a name="geocode-address-names-mode-dev-tips"></a>
+ S'il n'est pas défini, le service renvoie des noms normalisés (officiels) par défaut.
+ `Administrative`s'applique actuellement uniquement aux adresses situées aux États-Unis d'Amérique.