Korzystając z interfejsu API weryfikacji adresów, możesz poprosić, aby odpowiedź z weryfikacji zwracała również adres przekształcony na język angielski. Użyj tej funkcji, gdy Twój system musi podać informacje o adresie w postaci znaków łacińskich, gdy otrzymasz adres w języku innym niż angielski. Na przykład:
- Twoja firma może realizować zamówienia z całego świata i używać znaków alfabetu łacińskiego i angielskich do standaryzacji wszystkich adresów.
- Twoja firma może obsługiwać przesyłki do i z kraju, w którym używa się innego języka niż język podany w adresie.
Jak zwrócić adres w języku angielskim
Aby poprosić o weryfikację adresu z uwzględnieniem komponentów w języku angielskim, dodaj do treści prośby o weryfikację:
languageOptions: { returnEnglishLatinAddress: "true" }.
W tym przykładzie podczas weryfikowania adresu muzeum Prado żądane są 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 w sekcji Przykład konwersji polegającej na wypełnieniu formularza kontaktowego. Każdy element zwróconego adresu w języku lokalnym jest jak najlepiej przekształcany na język angielski. Zamienionego adresu nie można ponownie użyć jako danych wejściowych interfejsu API.
Pole englishLatinAddress używa tego samego protokołu Address
proto co pole address, z tymi wyjątkami:
- Brak pola
ConfirmationLevel - Brak pola
unconfirmedComponentTypes
Jak działa konwersja adresu
Interfejs API do weryfikacji adresów stosuje konwersję na język angielski do każdego elementu adresu. Oznacza to, że administrative_area, locality i inne elementy adresu są traktowane oddzielnie. Aby poznać listę komponentów adresu, zapoznaj się z dokumentacją referencyjną AddressComponent.
Poniższy diagram pokazuje, jak wygląda konwersja w języku angielskim w przypadku adresu Calle Dueñas, 5, 41003 Sevilla, Hiszpania.
W przypadku każdego komponentu ocenianego pod kątem konwersji w języku angielskim usługa stosuje proces opisany w następnych sekcjach.
W miarę możliwości używa angielskiego w wersji pełnej.
Niektóre komponenty adresu mogą mieć w ofercie w pełni przetłumaczoną wersję.
Na przykład hiszpański kraj España zostanie przetłumaczony na Spain. W takim przypadku usługa używa angielskiej wersji. Zwykle dotyczy to większych elementów adresu, takich jak country i administrative_area_level_1.
Jeśli język angielski jest niedostępny, używa transliteracji lokalnego języka na alfabet łaciński.
Latynizacja oznacza, że lokalny język jest konwertowany na pismo łacińskie za pomocą transkrypcji.
- Jeśli lokalny język adresu używa alfabetu łacińskiego, a nie ma angielskiego odpowiednika danego elementu adresu, usługa zastępuje znaki z języka lokalnego, które nie są oparte na języku angielskim.
Na przykład
Calle Dueñasstaje sięCalle Duenas, gdzie ñ jest zastępowane przez n. - Jeśli lokalny język adresu nie używa alfabetu łacińskiego i nie ma angielskiego odpowiednika danego elementu adresu, usługa używa wersji łacińskiej lokalnego języka (jeśli jest dostępna).
Na przykład konwersja z japońskiego zwraca łacińską transkrypcję japońską.
Wszystkie znaki inne niż angielskie i łacińskie są zastępowane znakami angielskimi i łacińskimi. Na przykład: ３丁目 zmieni się na 3-chome.
- Pamiętaj, że japoński nie jest jeszcze dostępny w wersji podglądu
- Jeśli wersja języka łacińskiego jest niedostępna, komponenty są zwracane w języku lokalnym.
Zastępuje znaki łacińskie, które nie występują w języku angielskim
Wszystkie znaki łacińskie, które nie są używane w języku angielskim, są zastępowane ich odpowiednikami w języku angielskim. Na przykład każdy z tych znaków zostanie zastąpiony znakiem „o”: ð, ò, ó, ô, õ, ö, ø, ō, ŏ, õ, ơ, ṍ, ṏ, ṑ, ṓ, ọ, ỏ, ố, ồ, ổ, ỗ, ộ, ớ, ờ, ở, ỡ i w razie potrzeby . Na przykład:
Calle de Ruiz de Alarcón staje się Calle de Ruiz de Alarcon
Przykład konwersji polegającej na wypełnieniu formularza
Ten przykład pokazuje odpowiedź weryfikacyjną na żądanie dotyczące Palacio de las Dueñas w Hiszpanii, z zaznaczeniem englishLatinAddress pogrubieniem. To żądanie używało pola returnEnglishLatinAddress w parametry languageOptions na wejściu.
"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"
Opcje pomocy w przypadku wersji w wersji próbnej
Chociaż Google nie zapewnia pomocy w zakresie wersji Preview, funkcji i funkcjonalności Usług, rozważamy prośby na tych etapach rozwoju w każdej sprawie osobno.
W przypadku wersji przed GA zastosuj te rekomendacje:
Funkcje w fazie przed GA nie są objęte gwarancją jakości usług Google Maps Platform.
Używaj mechanizmów zastępczych, zwłaszcza jeśli korzystasz z funkcji w wersji przed GA w środowisku produkcyjnym. Przykłady sytuacji, w których występują alternatywne scenariusze: przekroczenie limitu, nieoczekiwane kody odpowiedzi i opóźnienia lub nieoczekiwane odpowiedzi w porównaniu z obecnym działaniem.
Możesz użyć śledzenia problemów, aby poprosić o dodanie nowych funkcji lub zaproponować zmiany w dotychczasowych. W treści swojej prośby umieść:
Opisz konkretną funkcję lub zachowanie, które chcesz dodać, a także wyjaśnij, dlaczego uważasz, że jest to ważne.
Jeśli to możliwe, podaj szczegółowe informacje o przypadku użycia i nowych możliwościach, które ta funkcja umożliwi.
Aby przekazać opinię lub zadać pytanie dotyczące funkcji, wyślij e-maila na adres address-validation-hotline@google.com.