本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 如何取得次要地址
`SecondaryAddresses` 可讓您擷取主要地址下的所有次要地址。此外，如果 中存在任何 ， `Geocode`也會傳回次要單位`QueryText`。
如果針對該國家/地區有剖析查詢支援 `ParsedQuery.Address.SecondaryAddressComponents`，則`InferredSecondaryAddress`可能會傳回位置類型為 的結果項目。會根據查詢中提供的資料傳回`InferredSecondaryAddress`結果。
## 潛在的使用案例
+ **地址表單完成：**選取更準確的次要地址，其中包含更準確的位置資訊。
+ **交付：**對於缺少次要地址涵蓋範圍的國家/地區，此資訊可以透過包含所有提供的單位資訊來協助通知交付。
## 範例
### 取得次要地址
**注意**
涵蓋範圍`Address.SecondaryAddressComponents`適用於下列國家/地區：
AUS、CAN、NZL、美國、RI
涵蓋範圍`ParsedQuery.Address.SecondaryAddressComponents`適用於下列國家/地區：
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": "",
"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": "",
"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": "",
"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"
```
------
### 取得在 地址中提供的次要單位
此功能的涵蓋範圍適用於下列國家/地區：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": "",
"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": "",
"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"
```
------