Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Come controllare le varianti dei nomi degli indirizzi
AddressNamesModespecifica come vengono restituiti i nomi degli indirizzi. Se non è impostato, il servizio restituisce nomi normalizzati (ufficiali) per impostazione predefinita. Se impostato suMatched, i nomi degli indirizzi nella risposta si basano sulla query di input anziché sui nomi ufficiali. Se impostato suAdministrative, il servizio restituisce i nomi amministrativi ufficiali per i componenti dell'indirizzo. Administrativeattualmente si applica solo agli indirizzi negli Stati Uniti d'America.
Casi d'uso potenziali
-
Completamento del modulo di indirizzo: Matched consente di restituire nomi coerenti con quelli digitati dall'utente, riducendo la confusione nei flussi di lavoro di completamento automatico.
-
Standardizzazione degli indirizzi: Administrative da utilizzare per normalizzare i nomi delle città secondo il formato amministrativo ufficiale per la qualità e la deduplicazione dei dati.
Esempi
- 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
- 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
Suggerimenti per gli sviluppatori
-
Se non è impostato, il servizio restituisce nomi normalizzati (ufficiali) per impostazione predefinita.
-
Administrativeattualmente si applica solo agli indirizzi negli Stati Uniti d'America.