Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Cómo controlar las variantes de nombres de direcciones
AddressNamesModeespecifica cómo se devuelven los nombres de las direcciones. Si no se establece, el servicio devuelve los nombres normalizados (oficiales) de forma predeterminada. Si se establece enMatched, los nombres de las direcciones de la respuesta se basan en la consulta de entrada y no en los nombres oficiales. Si se establece enAdministrative, el servicio devuelve los nombres administrativos oficiales de los componentes de la dirección. Administrativeactualmente solo se aplica a direcciones en los Estados Unidos.
Casos de uso potenciales
-
Cumplimentación del formulario de direcciones: se utiliza Matched para devolver nombres que coincidan con lo que escribió el usuario, lo que reduce la confusión en los flujos de trabajo de autocompletado.
-
Estandarización de direcciones: se utiliza Administrative para normalizar los nombres de las ciudades y adaptarlos a su formulario administrativo oficial para mejorar la calidad de los datos y la deduplicación.
Ejemplos
- 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
Consejos de desarrolladores
-
Si no se establece, el servicio devuelve los nombres normalizados (oficiales) de forma predeterminada.
-
Administrativeactualmente solo se aplica a direcciones en los Estados Unidos.
