Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# So kontrollieren Sie Varianten von Adressnamen
<a name="how-to-geocode-address-names-mode"></a>

`AddressNamesMode`gibt an, wie Adressnamen zurückgegeben werden. Wenn nicht gesetzt, gibt der Dienst standardmäßig normalisierte (offizielle) Namen zurück. Wenn auf gesetzt`Matched`, basieren die Adressnamen in der Antwort auf der Eingabeabfrage und nicht auf offiziellen Namen. Wenn diese Option auf gesetzt ist`Administrative`, gibt der Dienst die offiziellen Administratornamen für Adresskomponenten zurück. `Administrative`gilt derzeit nur für Adressen in den Vereinigte Staaten.

## Mögliche Anwendungsfälle
<a name="geocode-address-names-mode-use"></a>
+ **Ausfüllen von Adressformularen:** Wird verwendet`Matched`, um Namen zurückzugeben, die dem entsprechen, was der Benutzer eingegeben hat, wodurch Verwirrung in Workflows zur automatischen Vervollständigung vermieden wird.
+ **Standardisierung von Adressen: Wird** verwendet`Administrative`, um Städtenamen im Hinblick auf Datenqualität und Deduplizierung auf ihre offizielle Verwaltungsform zu normalisieren.

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

### Verwenden Sie den Modus Zugeordnet
<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
```

------

### Verwenden Sie den Administratormodus
<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
```

------

## Tipps für Entwickler
<a name="geocode-address-names-mode-dev-tips"></a>
+ Wenn nicht gesetzt, gibt der Dienst standardmäßig normalisierte (offizielle) Namen zurück.
+ `Administrative`gilt derzeit nur für Adressen in den Vereinigte Staaten.