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 obtenir des adresses secondaires
`SecondaryAddresses`vous permet de récupérer toutes les adresses secondaires qui se trouvent sous une adresse principale. En outre, renvoie `Geocode` également les unités secondaires, le cas échéant, dans le`QueryText`.
Un élément de résultat avec un type de lieu `InferredSecondaryAddress` peut être renvoyé s'il existe un support de requête analysée pour ce pays. `ParsedQuery.Address.SecondaryAddressComponents` `InferredSecondaryAddress`les résultats sont renvoyés en fonction des données fournies dans la requête.
## Cas d'utilisation potentiels
+ **Remplissage du formulaire d'adresse :** pour sélectionner une adresse secondaire plus précise, qui inclut également des informations de position plus précises.
+ **Livraisons :** pour les pays où les adresses secondaires ne sont pas couvertes, ces informations peuvent aider à éclairer les livraisons en incluant toutes les informations relatives aux unités fournies.
## Exemples
### Obtenir des adresses secondaires
**Note**
La couverture pour `Address.SecondaryAddressComponents` est disponible dans les pays suivants :
AUSTRALIE, CANADA, NZL, ÉTATS-UNIS, PÉROU
La couverture pour `ParsedQuery.Address.SecondaryAddressComponents` est disponible dans les pays suivants :
AUS, AUT, BRA, CAN, ESP, FRA, GBR, HKG, IDN, IND, NZL, TUR, TWN, ÉTATS-UNIS
------
#### [ 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"
```
------
### Obtenir des unités secondaires fournies dans une adresse
La couverture de cette fonctionnalité est disponible dans les pays suivants : AUS, AUT, BRA, CAN, ESP, FRA, GBR, IDN, IND, NZL, TUR, TWN, États-Unis.
------
#### [ 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"
```
------