Ao usar a API Address Validation, você pode solicitar que uma resposta de validação também retorne o endereço convertido para o inglês. Use esse recurso quando o sistema precisar fornecer informações de endereço em caracteres latinos do inglês ao receber um endereço de um idioma diferente do inglês. Por exemplo:
- Sua empresa pode atender a solicitações de envio de todo o mundo e usar caracteres latinos de inglês e inglês para padronizar todos os endereços.
- Sua empresa pode fazer envios de e para um país que usa um idioma diferente daquele do endereço fornecido.
Como devolver um endereço em inglês
Para solicitar uma validação de endereço com componentes equivalentes em inglês incluídos, adicione o seguinte ao corpo da solicitação de validação:
languageOptions: { returnEnglishLatinAddress: "true" }.
O exemplo a seguir solicita componentes em inglês para verificar o endereço no Museu do 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'
A resposta retorna o endereço em inglês no campo englishLatinAddress. Consulte o exemplo de conversão de endereço abaixo para mais detalhes. Cada
componente do endereço de idioma local retornado é convertido para o inglês da
melhor forma possível. O endereço convertido não é reutilizável como entrada para a API.
O campo englishLatinAddress usa o mesmo proto
Endereço
que o campo address, com as seguintes exceções:
- Nenhum campo
ConfirmationLevel - Não há campo
unconfirmedComponentTypes
Como a conversão de endereço funciona
A API Address Validation aplica a conversão em inglês a cada componente do
endereço. Isso significa que administrative_area, locality e outros
componentes do endereço são tratados individualmente. Consulte AddressComponent na documentação de referência para ver uma lista dos componentes de endereço.
O diagrama a seguir ilustra como seria a conversão em inglês para o endereço Calle Dueñas, 5, 41003 Sevilla, España.
Para cada componente avaliado para conversão em inglês, o serviço usa o processo descrito nas seções a seguir.
Usar o inglês totalmente traduzido sempre que possível
Alguns componentes de endereço podem ter uma versão totalmente traduzida disponível para uso.
Por exemplo, o país espanhol de España seria traduzido para Spain. Nesse
caso, o serviço usa a versão em inglês. Geralmente, esse é o caso de componentes de endereço maiores, como country e administrative_area_level_1.
Usa latinização do idioma local se o inglês não estiver disponível.
Latimização significa que o idioma local é convertido para o alfabeto latino por meio da transcrição.
- Se o idioma local do endereço usar um conjunto de caracteres latinos e não houver um equivalente em inglês para o componente de endereço, o serviço
substituirá os caracteres do idioma local que não se baseiam no inglês.
Por exemplo,
Calle Dueñasse tornaCalle Duenas, em que ñ é substituído por n. - Se o idioma local do endereço não usar um conjunto de caracteres baseados em latino e não houver equivalente em inglês para o componente de endereço, o serviço usará uma versão latinizada do idioma local, se disponível.
Por exemplo, uma conversão japonesa retorna a romanização do japonês.
Todos os caracteres diferentes do inglês e não latinos são substituídos por caracteres latinos
baseados no inglês. Por exemplo: 3丁目 torna-se 3-chome.
- A visualização em japonês ainda não está ativada.
- Se uma versão latinizada do idioma não estiver disponível, os componentes serão retornados no idioma local.
Substitui caracteres latinos que não estão em inglês
Todos os caracteres latinos que não estejam em inglês são substituídos pelo equivalente em inglês. Por exemplo, cada um dos caracteres a seguir seria substituído pelo caractere "o": '>< Por exemplo:
Calle de Ruiz de Alarcón agora Calle de Ruiz de Alarcon
Exemplo de conversão de endereço
O exemplo a seguir mostra uma resposta de validação de uma solicitação para o Palacio de las Dueñas na Espanha, com englishLatinAddress em negrito. Essa solicitação usou o campo returnEnglishLatinAddress no parâmetro languageOptions na 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"