Quando utilizzi l'API Address Validation, puoi richiedere che una risposta di convalida restituisca anche l'indirizzo convertito in inglese. Utilizza questa funzionalità quando il sistema deve fornire informazioni sull'indirizzo in caratteri latini in inglese e riceve un indirizzo che ha origine in una lingua diversa dall'inglese. Ad esempio:
- La tua azienda potrebbe soddisfare richieste di spedizione da tutto il mondo e utilizzare i caratteri latini basati sull'inglese e sull'inglese per standardizzare tutti gli indirizzi.
- La tua attività potrebbe gestire le spedizioni da e verso un paese che utilizza una lingua diversa da quella dell'indirizzo fornito.
Come restituire un indirizzo in inglese
Per richiedere una convalida dell'indirizzo con componenti inclusi equivalenti all'inglese, aggiungi quanto segue al corpo della richiesta di convalida:
languageOptions: { returnEnglishLatinAddress: "true" }.
L'esempio seguente richiede componenti in inglese durante la verifica dell'indirizzo al 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 risposta restituisce l'indirizzo in inglese nel campo englishLatinAddress. Per maggiori dettagli, consulta l'esempio di conversione dell'indirizzo di seguito. Ogni componente dell'indirizzo nella lingua locale restituito viene convertito al meglio in inglese. L'indirizzo convertito non è riutilizzabile come input nell'API.
Il campo englishLatinAddress utilizza lo stesso protocollo
Address
del campo address, con le seguenti eccezioni:
- Nessun campo
ConfirmationLevel - Nessun campo
unconfirmedComponentTypes
Come funziona la conversione degli indirizzi
L'API Address Validation applica la conversione in inglese a ogni componente dell'indirizzo. Ciò significa che administrative_area, locality e altri
componenti dell'indirizzo vengono trattati singolarmente. Consulta AddressComponent nella documentazione di riferimento per un elenco dei componenti dell'indirizzo.
Il seguente diagramma mostra l'aspetto della conversione in inglese per l'indirizzo Calle Dueñas, 5, 41003 Sevilla, España.
Per ogni componente valutato per la conversione in inglese, il servizio utilizza il processo descritto nelle sezioni seguenti.
Utilizza la versione integrale dell'inglese ove possibile
Per alcuni componenti dell'indirizzo potrebbe essere disponibile una versione completamente tradotta.
Ad esempio, il paese spagnolo España verrà tradotto in Spain. In questo caso il servizio utilizza la versione in inglese. In genere questo si verifica per componenti indirizzo più grandi, come country e administrative_area_level_1.
Viene utilizzata la latinizzazione della lingua locale se l'inglese non è disponibile
La latinizzazione significa che la lingua locale viene convertita in latino tramite la trascrizione.
- Se la lingua locale dell'indirizzo utilizza un set di caratteri latini e non esiste un equivalente inglese per il componente dell'indirizzo, il servizio sostituisce i caratteri della lingua locale che non sono basati sull'inglese.
Ad esempio,
Calle DueñasdiventaCalle Duenas, dove ñ viene sostituito con n. - Se la lingua locale dell'indirizzo non utilizza un set di caratteri latino e non esiste un equivalente in inglese per il componente dell'indirizzo, il servizio utilizza una versione latina della lingua locale, se disponibile.
Ad esempio, una conversione giapponese restituisce la romanizzazione del giapponese.
Tutti i caratteri non inglesi e non latini vengono sostituiti con i caratteri latini basati sull'inglese. Ad esempio: 3丁目 diventa 3-chome.
- Tieni presente che il giapponese non è ancora abilitato per l'anteprima
- Se non è disponibile una versione latina della lingua, i componenti vengono restituiti nella lingua locale.
Sostituisce i caratteri latini non in inglese
Tutti i caratteri latini non in inglese vengono sostituiti con l'equivalente in caratteri latini. Ad esempio, ognuno dei seguenti caratteri verrà sostituito dal carattere "o": 🎉, ò, ó, ô, õ, ö, ø, ō, giu, ő, ơ, ṍ, ṏ, ṑ, ṓ, 장, ỏ, ố, ử, 장, ỏ, Á, richiamata, Ad esempio:
Calle de Ruiz de Alarcón diventa Calle de Ruiz de Alarcon
Esempio di conversione dell'indirizzo
L'esempio seguente mostra una risposta di convalida a una richiesta per il Palacio
de las Dueñas in Spagna, con il carattere englishLatinAddress in grassetto. Per questa richiesta è stato utilizzato il campo returnEnglishLatinAddress nel parametro languageOptions nell'input.
"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"