Lorsque vous utilisez l'API Address Validation, vous pouvez demander qu'une réponse de validation renvoie également l'adresse convertie en anglais. Utilisez cette fonctionnalité lorsque votre système doit fournir des informations d'adresse en caractères latins basés sur l'anglais lorsqu'il reçoit une adresse provenant d'une autre langue que l'anglais. Exemple :
- Votre entreprise peut traiter des demandes de livraison provenant du monde entier et utiliser des caractères latins en anglais et en anglais pour standardiser toutes les adresses.
- Votre entreprise peut traiter des expéditions à destination et en provenance d'un pays dont la langue est différente de celle de l'adresse fournie.
Comment renvoyer une adresse en anglais
Pour demander une validation d'adresse avec des composants équivalents en anglais inclus, ajoutez le code suivant au corps de la requête de validation:
languageOptions: { returnEnglishLatinAddress: "true" }.
L'exemple suivant demande des composants en anglais lors de la validation de l'adresse au musée du 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 réponse renvoie l'adresse en anglais dans le champ englishLatinAddress. Pour en savoir plus, consultez l'exemple de conversion d'adresse ci-dessous. Chaque composant de l'adresse dans la langue locale renvoyée est converti en anglais du mieux possible. L'adresse convertie ne peut pas être réutilisée en tant qu'entrée dans l'API.
Le champ englishLatinAddress utilise le même protocole Address que le champ address, à quelques exceptions près:
- Aucun champ
ConfirmationLevel - Aucun champ
unconfirmedComponentTypes
Fonctionnement de la conversion d'adresse
L'API Address Validation applique une conversion en anglais à chaque composant de l'adresse. Cela signifie que administrative_area, locality et les autres composants de l'adresse sont traités individuellement. Consultez la section AddressComponent dans la documentation de référence pour obtenir la liste des composants d'adresse.
Le schéma suivant illustre une conversion en anglais pour l'adresse Calle Dueñas, 5, 41003 Sevilla, Espagne.
Pour chaque composant dont la conversion en anglais est évaluée, le service utilise le processus décrit dans les sections suivantes.
Utilise l'anglais entièrement traduit dans la mesure du possible.
Une version entièrement traduite peut être utilisée pour certains composants d'adresse.
Par exemple, l'espagnol (España) serait traduit par Spain. Dans ce cas, le service utilise la version en anglais. C'est généralement le cas pour des composants d'adresse plus volumineux, tels que country et administrative_area_level_1.
Utilise la latinisation de la langue locale si l'anglais n'est pas disponible.
La latinisation signifie que la langue locale est convertie en caractères latins à l'aide de la transcription.
- Si la langue locale de l'adresse utilise un jeu de caractères latins et qu'aucun équivalent en anglais n'existe pour le composant d'adresse, le service remplace les caractères de la langue locale qui ne sont pas basés sur l'anglais.
Par exemple,
Calle DueñasdevientCalle Duenas, où "ñ" est remplacé par "n". - Si la langue locale de l'adresse n'utilise pas de jeu de caractères latin et qu'aucun équivalent en anglais n'existe pour le composant d'adresse, le service utilise une version latinisée de la langue locale, le cas échéant.
Par exemple, une conversion en japonais renvoie la romanisation du japonais.
Tous les caractères non anglais et non latins sont remplacés par des caractères latins basés sur l'anglais. Par exemple : "3丁目" devient 3-chome.
- Notez que le japonais n'est pas encore disponible en version preview.
- Si aucune version latinisée de la langue n'est disponible, les composants sont renvoyés dans la langue locale.
Remplace des caractères latins qui ne sont pas en anglais
Tous les caractères latins qui ne sont pas en anglais sont remplacés par leur équivalent en anglais. Par exemple, chacun des caractères suivants devrait être remplacé par le caractère "o": ð, ò, ó, ô, õ, ö, ø, ō, soumettre, õ, ơ, ṍ, ṏ, ṑ, ṓ, テ, ỏ, ố, ồ, ờ, ỏ, ố, ồ, ờ, ỏ, Object, ồ, đ. Exemple :
Calle de Ruiz de Alarcón devient Calle de Ruiz de Alarcón
Exemple de conversion d'adresse
L'exemple suivant montre une réponse de validation à la suite d'une requête pour le Palacio de las Dueñas en Espagne, avec englishLatinAddress en gras. Cette requête a utilisé le champ returnEnglishLatinAddress du paramètre languageOptions de l'entrée.
"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"