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 erhalten Sie sekundäre Adressen
<a name="get-secondary-address"></a>

`SecondaryAddresses`ermöglicht es Ihnen, alle Sekundäradressen abzurufen, die sich unter einer Hauptadresse befinden. Gibt darüber hinaus `Geocode` auch Sekundäreinheiten zurück, falls welche in der vorhanden sind`QueryText`. 

Ein Ergebniselement mit dem Ortstyp von `InferredSecondaryAddress` kann zurückgegeben werden, wenn für dieses Land eine geparste Abfrage,`ParsedQuery.Address.SecondaryAddressComponents`, unterstützt wird. `InferredSecondaryAddress`Die Ergebnisse werden auf der Grundlage der in der Abfrage bereitgestellten Daten zurückgegeben. 

## Mögliche Anwendungsfälle
<a name="get-secondary-address-use"></a>
+ **Ausfüllen des Adressformulars:** Um eine genauere sekundäre Adresse auszuwählen, die auch genauere Positionsinformationen enthält.
+ **Lieferungen:** In Ländern, in denen die sekundäre Adresse nicht abgedeckt ist, können diese Informationen als Grundlage für Lieferungen dienen, da sie alle angegebenen Einheiteninformationen enthalten.

## Beispiele
<a name="get-secondary-address-example"></a>

### Holen Sie sich sekundäre Adressen
<a name="get-secondary-addresses"></a>

**Anmerkung**  
Der Versicherungsschutz für `Address.SecondaryAddressComponents` ist in den folgenden Ländern verfügbar:  
AUS, CAN, NZL, USA, PRI  
Der Versicherungsschutz für `ParsedQuery.Address.SecondaryAddressComponents` ist in den folgenden Ländern verfügbar:  
AUS, AUT, BRA, CAN, ESP, FRA, GBR, HKG, IDN, IND, NZL, TUR, TWN, USA

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

```
{
    "QueryText":"910 Beach Avenue, Vancouver",
    "AdditionalFeatures": ["SecondaryAddresses"]
}
```

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

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "910 Beach Ave, Vancouver, BC V6Z 2W7, Canada",
            "Address": {
                "Label": "910 Beach Ave, Vancouver, BC V6Z 2W7, Canada",
                "Country": {
                    "Code2": "CA",
                    "Code3": "CAN",
                    "Name": "Canada"
                },
                "Region": {
                    "Code": "BC",
                    "Name": "British Columbia"
                },
                "SubRegion": {
                    "Name": "Metro Vancouver"
                },
                "Locality": "Vancouver",
                "District": "Downtown Vancouver",
                "PostalCode": "V6Z 2W7",
                "Street": "Beach Ave",
                "StreetComponents": [
                    {
                        "BaseName": "Beach",
                        "Type": "Ave",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": " ",
                        "Language": "en"
                    }
                ],
                "AddressNumber": "910"
            },
            "Position": [
                -123.13325,
                49.27542
            ],
            "MapView": [
                -123.13463,
                49.27452,
                -123.13187,
                49.27632
            ],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": {
                        "Locality": 1,
                        "Intersection": [
                            1
                        ],
                        "AddressNumber": 1
                    }
                }
            },
            "ParsedQuery": {
                "Address": {
                    "Locality": [
                        {
                            "StartIndex": 18,
                            "EndIndex": 27,
                            "Value": "Vancouver",
                            "QueryComponent": "Query"
                        }
                    ],
                    "Street": [
                        {
                            "StartIndex": 4,
                            "EndIndex": 16,
                            "Value": "Beach Avenue",
                            "QueryComponent": "Query"
                        }
                    ],
                    "AddressNumber": [
                        {
                            "StartIndex": 0,
                            "EndIndex": 3,
                            "Value": "910",
                            "QueryComponent": "Query"
                        }
                    ]
                }
            },
            "SecondaryAddresses": [
                {
                    "PlaceId": "<Redacted>",
                    "PlaceType": "SecondaryAddress",
                    "Title": "101-910 Beach Ave, Vancouver, BC V6Z 2W7, Canada",
                    "Address": {
                        "Label": "101-910 Beach Ave, Vancouver, BC V6Z 2W7, Canada",
                        "SecondaryAddressComponents": [
                            {
                                "Number": "101"
                            }
                        ]
                    },
                    "Position": [
                        -123.1334,
                        49.27532
                    ]
                },
                {
                    "PlaceId": "<Redacted>",
                    "PlaceType": "SecondaryAddress",
                    "Title": "102-910 Beach Ave, Vancouver, BC V6Z 2W7, Canada",
                    "Address": {
                        "Label": "102-910 Beach Ave, Vancouver, BC V6Z 2W7, Canada",
                        "SecondaryAddressComponents": [
                            {
                                "Number": "102"
                            }
                        ]
                    },
                    "Position": [
                        -123.1334,
                        49.27532
                    ]
                },
                ...
             ]
         }
    ]
}
```

------
#### [ 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":"910 Beach Avenue, Vancouver",
    "AdditionalFeatures": ["SecondaryAddresses"]
}'
```

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

```
aws geo-places geocode --key ${YourKey} --query-text "910 Beach Avenue, Vancouver" --additional-features "SecondaryAddresses"
```

------

### Lassen Sie sich Sekundäreinheiten an einer Adresse bereitstellen
<a name="get-all-secondary-units"></a>

Diese Funktionalität ist in den folgenden Ländern verfügbar: AUS, AUT, BRA, CAN, ESP, FRA, GBR, IDN, IND, NZL, TUR, TWN, USA.

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

```
{
  "QueryText": "101-910 Beach Avenue, Vancouver"
}
```

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

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "SecondaryAddress",
            "Title": "101-910 Beach Ave, Vancouver, BC V6Z 2W7, Canada",
            "Address": {
                "Label": "101-910 Beach Ave, Vancouver, BC V6Z 2W7, Canada",
                "Country": {
                    "Code2": "CA",
                    "Code3": "CAN",
                    "Name": "Canada"
                },
                "Region": {
                    "Code": "BC",
                    "Name": "British Columbia"
                },
                "SubRegion": {
                    "Name": "Metro Vancouver"
                },
                "Locality": "Vancouver",
                "District": "Downtown Vancouver",
                "PostalCode": "V6Z 2W7",
                "Street": "Beach Ave",
                "StreetComponents": [
                    {
                        "BaseName": "Beach",
                        "Type": "Ave",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": " ",
                        "Language": "en"
                    }
                ],
                "AddressNumber": "910",
                "SecondaryAddressComponents": [
                    {
                        "Number": "101"
                    }
                ]
            },
            "Position": [
                -123.1334,
                49.27532
            ],
            "MapView": [
                -123.13478,
                49.27442,
                -123.13202,
                49.27622
            ],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": {
                        "Locality": 1,
                        "Intersection": [
                            1
                        ],
                        "AddressNumber": 1,
                        "SecondaryAddressComponents": [
                            {
                                "Number": 1
                            }
                        ]
                    }
                }
            },
            "ParsedQuery": {
                "Address": {
                    "Locality": [
                        {
                            "StartIndex": 22,
                            "EndIndex": 31,
                            "Value": "Vancouver",
                            "QueryComponent": "Query"
                        }
                    ],
                    "Street": [
                        {
                            "StartIndex": 8,
                            "EndIndex": 20,
                            "Value": "Beach Avenue",
                            "QueryComponent": "Query"
                        }
                    ],
                    "AddressNumber": [
                        {
                            "StartIndex": 4,
                            "EndIndex": 7,
                            "Value": "910",
                            "QueryComponent": "Query"
                        }
                    ],
                    "SecondaryAddressComponents": [
                        {
                            "StartIndex": 0,
                            "EndIndex": 3,
                            "Value": "101",
                            "Number": "101",
                            "Designator": "unknown"
                        }
                    ]
                }
            },
            "MainAddress": {
                "PlaceId": "<Redacted>",
                "PlaceType": "PointAddress",
                "Title": "910 Beach Ave, Vancouver, BC V6Z 2W7, Canada",
                "Address": {
                    "Label": "910 Beach Ave, Vancouver, BC V6Z 2W7, Canada"
                },
                "Position": [
                    -123.13325,
                    49.27542
                ]
            }
        }
    ]
}
```

------
#### [ 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":"101-910 Beach Avenue, Vancouver"
}'
```

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

```
aws geo-places geocode --key ${YourKey} --query-text "101-910 Beach Avenue, Vancouver"
```

------