Cuando usas la API de Address Validation, puedes solicitar que la respuesta de validación también muestre la dirección convertida al inglés. Usa esta función si tu sistema necesita proporcionar información de dirección en caracteres latinos del inglés cuando reciba una dirección que se origine en un idioma distinto del inglés. Por ejemplo:
- Tu empresa podría entregar solicitudes de envío de todo el mundo y usar caracteres latinos que se encuentren en inglés y en inglés para estandarizar todas las direcciones.
- Es posible que tu empresa se encargue de los envíos desde y hacia un país que usa un idioma diferente al de la dirección proporcionada.
Cómo devolver una dirección en inglés
Para solicitar una validación de la dirección con componentes equivalentes en inglés, agrega lo siguiente al cuerpo de la solicitud de validación:
languageOptions: { returnEnglishLatinAddress: "true" }.
En el siguiente ejemplo, se solicitan componentes basados en inglés mientras se verifica la dirección en el Museo del Prado:
curl -X POST -d '{
"regionCode" : ["ES"],
"addressLines": ["C. de Ruiz de Alarcón, 23, 28014 Madrid, Spain"],
"languageOptions": {returnEnglishLatinAddress: true}
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: API_KEY' \
'https://addressvalidation.googleapis.com/v1:validateAddress'
La respuesta muestra la dirección en inglés en el campo englishLatinAddress. Consulta el ejemplo de conversión de dirección a continuación para obtener más detalles. Cada componente de la dirección del idioma local que se muestra se convierte al inglés lo mejor posible. La dirección convertida no se puede reutilizar como una entrada a la API.
El campo englishLatinAddress usa el mismo protocolo Address que el campo address, con las siguientes excepciones:
- Sin campo
ConfirmationLevel - Sin campo
unconfirmedComponentTypes
Cómo funciona la conversión de direcciones
La API de Address Validation aplica la conversión en inglés a cada componente de la dirección. Esto significa que administrative_area, locality y otros componentes de la dirección se tratan de manera individual. Consulta AddressComponent en la documentación de referencia para obtener una lista de los componentes de dirección.
En el siguiente diagrama, se ilustra cómo sería la conversión en inglés para la dirección Calle Dueñas, 5, 41003 Sevilla, España.
Para cada componente evaluado para la conversión en inglés, el servicio usa el proceso que se describe en las siguientes secciones.
Usa traducciones completas en inglés siempre que sea posible.
Algunos componentes de la dirección pueden tener una versión traducida por completo disponible para su uso.
Por ejemplo, el país español de España se traducirá al Spain. En ese caso, el servicio usará la versión en inglés. Este suele ser el caso de los componentes de dirección más grandes, como country y administrative_area_level_1.
Usa la latinización del idioma local si no está disponible el inglés.
La latinización significa que el idioma local se convierte al alfabeto latino con la transcripción.
- Si el idioma local de la dirección usa un grupo de caracteres latinos y no existe un equivalente en inglés para el componente de la dirección, el servicio reemplaza los caracteres del idioma local que no se basan en inglés.
Por ejemplo,
Calle Dueñasse convierte enCalle Duenas, donde ñ se sustituye por n. - Si el idioma local de la dirección no usa un grupo de caracteres latinos y no existe un equivalente en inglés para el componente de la dirección, el servicio usa una versión latina del idioma local, si está disponible.
Por ejemplo, una conversión de japonés muestra la versión romanizada del japonés.
Todos los caracteres latinos que no sean del inglés ni los latinos se reemplazan por caracteres latinos que se encuentran en inglés. Por ejemplo: 3丁目 se convierte en 3-chome.
- Ten en cuenta que el japonés aún no está habilitado para la vista previa.
- Si no hay una versión latinizada del idioma disponible, los componentes se muestran en el idioma local.
Sustituye los caracteres latinos que no están en inglés.
Todos los caracteres latinos que no estén en inglés se reemplazan por su equivalente en inglés. Por ejemplo, cada uno de los siguientes caracteres se reemplazará por el carácter “o”: Por ejemplo:
Calle de Ruiz de Alarcón se convierte en Calle de Ruiz de Alarcón.
Ejemplo de conversión de dirección
En el siguiente ejemplo, se muestra una respuesta de validación a una solicitud para el Palacio de las Dueñas de España, con englishLatinAddress en negrita. Esta solicitud usó el campo returnEnglishLatinAddress del parámetro languageOptions de la entrada.
"result": {
"verdict": {
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
"hasInferredComponents": true
},
"address": {
"formattedAddress": "Calle Dueñas, 5, 41003 Sevilla, España",
"postalAddress": {
"regionCode": "ES",
"languageCode": "es",
"postalCode": "41003",
"administrativeArea": "Sevilla",
"locality": "Sevilla",
"addressLines": [
"C. Dueñas, 5"
]
},
"addressComponents": [
{
"componentName": {
"text": "Calle Dueñas",
"languageCode": "es"
},
"componentType": "route",
"confirmationLevel": "CONFIRMED"
},
{
"componentName": {
"text": "5",
"languageCode": "es"
},
"componentType": "street_number",
"confirmationLevel": "CONFIRMED"
},
{
"componentName": {
"text": "41003"
},
"componentType": "postal_code",
"confirmationLevel": "CONFIRMED"
},
{
"componentName": {
"text": "Sevilla",
"languageCode": "es"
},
"componentType": "locality",
"confirmationLevel": "CONFIRMED"
},
{
"componentName": {
"text": "España",
"languageCode": "es"
},
"componentType": "country",
"confirmationLevel": "CONFIRMED"
},
{
"componentName": {
"text": "Sevilla",
"languageCode": "es"
},
"componentType": "administrative_area_level_2",
"confirmationLevel": "CONFIRMED",
"inferred": true
}
]
},
"geocode": {
"location": {
"latitude": 37.394849,
"longitude": -5.9893604
},
"plusCode": {
"globalCode": "8C9P92V6+W7"
},
"bounds": {
"low": {
"latitude": 37.3948098,
"longitude": -5.9894249
},
"high": {
"latitude": 37.3948882,
"longitude": -5.9893025
}
},
"featureSizeMeters": 7.174035,
"placeId": "ChIJzRDYbgRsEg0RDDgHlF80UoI",
"placeTypes": [
"premise"
]
},
"metadata": {
"business": true,
"residential": false
},
"englishLatinAddress": {
"formattedAddress": "Calle Duenas, 5, 41003 Seville, Spain",
"postalAddress": {
"regionCode": "ES",
"languageCode": "en",
"postalCode": "41003",
"administrativeArea": "Seville",
"locality": "Seville",
"addressLines": [
"C. Duenas, 5"
]
},
"addressComponents": [
{
"componentName": {
"text": "Calle Duenas",
"languageCode": "es"
},
"componentType": "route",
},
{
"componentName": {
"text": "5",
"languageCode": "es"
},
"componentType": "street_number",
},
{
"componentName": {
"text": "41003"
},
"componentType": "postal_code",
},
{
"componentName": {
"text": "Seville",
"languageCode": "en"
},
"componentType": "locality",
},
{
"componentName": {
"text": "Spain",
"languageCode": "en"
},
"componentType": "country",
},
{
"componentName": {
"text": "Seville",
"languageCode": "en"
},
"componentType": "administrative_area_level_2",
"inferred": true
}
]
}
},
"responseId": "e874d263-7d0d-413f-9213-119a784765ed"