Jeśli korzystasz z interfejsu Address Validation API, możesz poprosić o to, aby odpowiedź weryfikująca zwracała również adres przekonwertowany na język angielski. Użyj tej funkcji, jeśli Twój system musi podawać informacje o adresie w języku angielskim alfabetem łacińskim w przypadku odbierania adresu pochodzącego z języka innego niż angielski. Przykład:
- Twoja firma może realizować zamówienia wysyłkowe z całego świata i używać angielskich oraz angielskich liter alfabetu łacińskiego, aby ujednolicić wszystkie adresy.
- Twoja firma może obsługiwać przesyłki z i do kraju, w którym używa się języka innego niż język podanego adresu.
Jak zwrócić adres w języku angielskim
Aby poprosić o weryfikację adresu za pomocą komponentów w języku angielskim, które zawierają odpowiedniki w języku angielskim, dodaj do treści żądania weryfikacji ten kod:
languageOptions: { returnEnglishLatinAddress: “true” }.
W tym przykładzie podczas weryfikacji adresu Muzeum Prado prosi się o komponenty w języku angielskim:
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'
Odpowiedź zwraca adres w języku angielskim w polu englishLatinAddress. Więcej informacji znajdziesz poniżej w sekcji Przykład konwersji adresu. Każdy składnik zwracanego adresu w języku lokalnym jest jak najlepiej konwertowany na angielski.
Pole englishLatinAddress korzysta z tego samego protokołu Address co pole address, z tymi wyjątkami:
- Brak pola
ConfirmationLevel - Brak pola
unconfirmedComponentTypes
Jak działa konwersja adresów
Interfejs Address Validation API stosuje konwersje w języku angielskim do każdego komponentu adresu. Oznacza to, że administrative_area, locality i inne składniki adresu są traktowane oddzielnie. Listę komponentów adresu znajdziesz w sekcji AddressComponent w dokumentacji referencyjnej.
Na diagramie poniżej widać, jak wygląda konwersja w języku angielskim dla adresu Calle Dueñas, 5, 41003 Sevilla, España.
W przypadku każdego komponentu ocenianego pod kątem konwersji w języku angielskim usługa korzysta z procesu opisanego w sekcjach poniżej.
W miarę możliwości w pełni przetłumaczone treści w języku angielskim
Niektóre komponenty adresu mogą mieć dostępną do użycia w pełni przetłumaczoną wersję.
Na przykład kraj España w Hiszpanii zostanie przetłumaczony na Spain. W takim przypadku usługa używa wersji angielskiej. Dzieje się tak zwykle w przypadku większych komponentów adresu, takich jak country i administrative_area_level_1.
Używa latynizacji w języku lokalnym, jeśli język angielski jest niedostępny
Latynoizacja oznacza, że lokalny język jest konwertowany na alfabet łaciński za pomocą transkrypcji.
- Jeśli w lokalnym języku adresu używany jest zestaw znaków łacińskich i nie ma odpowiednika w języku angielskim dla komponentu adresu, usługa zastępuje znaki z języka lokalnego, które nie sąwystępujące w języku angielskim.
Na przykład
Calle Dueñaszmienia się wCalle Duenas, gdzie ñ jest zastępowane liczbą n. - Jeśli w lokalnym języku adresu nie wykorzystuje się zestawu znaków łacińskiego i nie ma angielskiego odpowiednika składnika adresu, usługa używa latynoskiej wersji języka lokalnego, o ile jest dostępna.
Na przykład konwersja w języku japońskim zwraca latynizację słowa japońskiego.
Znaki inne niż łacińskie (inne niż angielski) są zastępowane znakami alfabetu łacińskiego. Na przykład: 3丁目 zostanie przekształcony w 3-chhome.
- Pamiętaj, że język japoński nie jest jeszcze dostępny w podglądzie.
- Jeśli taka wersja języka nie jest dostępna, komponenty są zwracane w języku lokalnym.
Zastępuje znaki łacińskie inne niż angielskie.
Znaki łacińskie w języku innym niż angielski są zastępowane ich odpowiednikami w języku angielskim. Na przykład każdy z następujących znaków zostałby zastąpiony znakiem „o”: ð, ò, ó, ô, õ, ö, ø, ō, elemencie ő, ơ, ṍ, ṏ, ṑ, ṓ, グ, ỏ, ố, ồ, ố, ố, đ, đ, Đ, \n, Przykład:
Calle de Ruiz de Alarcón zmienia nazwę na Calle de Ruiz de Alarcon
Przykład konwersji adresu
Poniższy przykład przedstawia odpowiedź weryfikacyjną przesłaną na prośbę dotyczącą Palacio de las Dueñas w Hiszpanii, przy czym englishLatinAddress jest pogrubiony. W tym żądaniu w danych wejściowych użyto pola returnEnglishLatinAddress w parametrze languageOptions.
"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"