Khi sử dụng API Xác thực địa chỉ, bạn có thể yêu cầu phản hồi xác thực cũng trả về địa chỉ được chuyển đổi sang tiếng Anh. Hãy dùng tính năng này khi hệ thống của bạn cần cung cấp thông tin địa chỉ bằng các ký tự Latinh dựa trên tiếng Anh khi nhận được địa chỉ có nguồn gốc bằng ngôn ngữ không phải tiếng Anh. Ví dụ:
- Công ty của bạn có thể đáp ứng các yêu cầu vận chuyển từ khắp nơi trên thế giới và sử dụng các ký tự Latinh trong tiếng Anh và tiếng Anh để chuẩn hoá tất cả địa chỉ.
- Doanh nghiệp của bạn có thể xử lý các chuyến hàng đến và đi từ một quốc gia sử dụng ngôn ngữ khác với ngôn ngữ trong địa chỉ bạn đã cung cấp.
Cách trả lại địa chỉ bằng tiếng Anh
Để yêu cầu xác thực địa chỉ bằng các thành phần tương đương với tiếng Anh đi kèm, hãy thêm đoạn mã sau vào nội dung yêu cầu xác thực:
languageOptions: { returnEnglishLatinAddress: "true" }.
Ví dụ sau đây yêu cầu các thành phần bằng tiếng Anh trong khi xác minh địa chỉ với Bảo tàng 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'
Phản hồi sẽ trả về địa chỉ bằng tiếng Anh trong trường englishLatinAddress. Hãy xem Ví dụ về việc chuyển đổi địa chỉ ở bên dưới để biết thông tin chi tiết. Mỗi thành phần của địa chỉ bằng ngôn ngữ địa phương được trả về sẽ được chuyển đổi sang tiếng Anh chính xác nhất có thể. Bạn không thể sử dụng lại địa chỉ đã chuyển đổi làm dữ liệu đầu vào cho API.
Trường englishLatinAddress sử dụng cùng một giao thức Address (Địa chỉ) như trường address sử dụng, với các ngoại lệ sau:
- Không có trường
ConfirmationLevel - Không có trường
unconfirmedComponentTypes
Cách hoạt động của tính năng chuyển đổi địa chỉ
API Xác thực địa chỉ áp dụng lượt chuyển đổi bằng tiếng Anh cho từng thành phần của địa chỉ. Điều này có nghĩa là administrative_area, locality và các thành phần khác của địa chỉ được xử lý riêng lẻ. Hãy xem AddressComponent trong tài liệu tham khảo để biết danh sách các thành phần địa chỉ.
Sơ đồ dưới đây minh hoạ cách chuyển đổi sang tiếng Anh cho địa chỉ Calle Dueñas, 5, 41003 Sevilla, España.
Đối với mỗi thành phần được đánh giá để chuyển đổi tiếng Anh, dịch vụ sẽ sử dụng quy trình được mô tả trong các phần sau.
Sử dụng bản dịch đầy đủ bằng tiếng Anh nếu có thể
Một số thành phần địa chỉ có thể có phiên bản được dịch đầy đủ để sử dụng.
Ví dụ: quốc gia Tây Ban Nha España sẽ được dịch sang Spain. Trong trường hợp đó, dịch vụ sẽ sử dụng phiên bản tiếng Anh. Trường hợp này thường xảy ra với các thành phần địa chỉ lớn hơn như country và administrative_area_level_1.
Sử dụng tiếng La-tinh của ngôn ngữ địa phương nếu không có tiếng Anh
La-tinh hoá có nghĩa là ngôn ngữ địa phương được chuyển đổi sang hệ thống chữ viết Latinh bằng cách chép lời.
- Nếu ngôn ngữ địa phương của địa chỉ sử dụng bộ ký tự Latinh và không có ngôn ngữ tương đương bằng tiếng Anh cho thành phần địa chỉ, thì dịch vụ sẽ thay thế các ký tự bằng ngôn ngữ địa phương không bằng tiếng Anh.
Ví dụ:
Calle Dueñastrở thànhCalle Duenas, trong đó ñ được thay thế bằng n. - Nếu ngôn ngữ địa phương của địa chỉ không sử dụng bộ ký tự dựa trên chữ Latinh và không có phiên bản tương đương bằng tiếng Anh cho thành phần địa chỉ, thì dịch vụ sẽ sử dụng phiên bản Latinh của ngôn ngữ địa phương (nếu có).
Ví dụ: chuyển đổi tiếng Nhật trả về phiên bản La-tinh của tiếng Nhật.
Mọi ký tự không phải tiếng Anh và không phải Latinh sẽ được thay thế bằng các ký tự Latinh dựa trên tiếng Anh. Ví dụ: 3丁目 trở thành 3-chome.
- Xin lưu ý rằng bản xem trước chưa bật tiếng Nhật
- Nếu không có phiên bản ngôn ngữ La-tinh, thì các thành phần sẽ được trả về bằng ngôn ngữ địa phương.
Thay thế các ký tự Latinh không có bằng tiếng Anh
Mọi ký tự La-tinh không phải bằng tiếng Anh sẽ được thay thế bằng ký tự tiếng Anh tương đương. Ví dụ: Mỗi ký tự sau đây sẽ được thay thế bằng ký tự "o": Đ, ò, ó, ô, õ, ö, ø, ō, li, ő, ơ, ṍ, ṏ, ṑ, ṓ, ọ, ỏ, ố, ào, ở, ư, , , , ơ, ờ, Ví dụ:
Calle de Ruiz de Alarcón trở thành Calle de Ruiz de Alarcon
Ví dụ về lượt chuyển đổi địa chỉ
Ví dụ sau đây cho thấy phản hồi xác thực của một yêu cầu về Palacio de las Dueñas ở Tây Ban Nha, trong đó englishLatinAddress được in đậm. Yêu cầu này đã sử dụng trường returnEnglishLatinAddress trong tham số languageOptions trong đầu vào.
"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"
Các tuỳ chọn hỗ trợ cho Bản dùng thử
Mặc dù Google không hỗ trợ các phiên bản, tính năng hoặc chức năng của Dịch vụ Xem trước, nhưng chúng tôi xem xét yêu cầu ở các giai đoạn phát triển này theo từng trường hợp.
Hãy áp dụng các đề xuất sau cho phiên bản trước giai đoạn phát hành rộng rãi:
Các tính năng trong giai đoạn trước khi phát hành rộng rãi không thuộc phạm vi điều chỉnh của SLA của Nền tảng Google Maps.
Sử dụng cơ chế dự phòng, đặc biệt là khi bạn đang sử dụng tính năng trước giai đoạn phát hành rộng rãi trong môi trường phát hành chính thức. Một số ví dụ về tình huống dự phòng: vượt quá hạn mức, mã phản hồi và độ trễ không mong muốn hoặc phản hồi không mong muốn khi so sánh với hành vi hiện có.
Bạn có thể sử dụng công cụ theo dõi lỗi để yêu cầu tính năng mới hoặc đề xuất sửa đổi các tính năng hiện có. Nhớ cung cấp những thông tin sau đây trong yêu cầu của bạn:
Mô tả tính năng hoặc hành vi cụ thể mà bạn muốn được bổ sung, cũng như lý do bạn cho rằng tính năng hoặc hành vi đó quan trọng.
Nếu có thể, hãy cung cấp thông tin cụ thể về trường hợp sử dụng của bạn và những cơ hội mới mà tính năng này cho phép.
Nếu có ý kiến phản hồi về vấn đề này hoặc bất kỳ câu hỏi nào khác về các tính năng, vui lòng gửi email đến Đường dây nóng về việc xác thực địa chỉ: address- entities-line@google.com.