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. Sử 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ỉ bằng ngôn ngữ không phải tiếng Anh. Ví dụ:
- Công ty của bạn có thể thực hiện các yêu cầu vận chuyển từ khắp nơi trên thế giới và sử dụng tiếng Anh và các ký tự Latinh dựa trên 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ả về địa chỉ bằng tiếng Anh
Để yêu cầu xác thực địa chỉ có các thành phần tương đương bằng tiếng Anh, hãy thêm nội dung sau vào phần nội dung yêu cầu xác thực:
languageOptions: { returnEnglishLatinAddress: "true" }.
Ví dụ sau yêu cầu các thành phần dựa trên tiếng Anh trong khi xác minh địa chỉ của 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ề lượt 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 proto Address (Địa chỉ) như trường address sử dụng, trừ 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ỉ
Address Validation API áp dụng quy trình chuyển đổi sang 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ẻ. 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 sang tiếng Anh, dịch vụ này 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 thành 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
Latinization (La-tinh hoá) có nghĩa là ngôn ngữ địa phương được chuyển đổi sang chữ viết La-tinh bằng cách sử dụng bản chép lời.
- Nếu ngôn ngữ địa phương của địa chỉ sử dụng bộ ký tự La-tinh và không có thành phần địa chỉ tương đương bằng tiếng Anh, thì dịch vụ sẽ thay thế các ký tự từ ngôn ngữ địa phương không dựa trên 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 tiếng Latinh và không có thành phần địa chỉ tương đương bằng tiếng Anh, thì dịch vụ sẽ sử dụng phiên bản latin hoá của ngôn ngữ địa phương (nếu có).
Ví dụ: một lượt chuyển đổi tiếng Nhật sẽ trả về bản chuyển đổi sang chữ La Mã của tiếng Nhật.
Mọi ký tự không phải tiếng Anh, không phải chữ Latinh đều được thay thế bằng ký tự Latinh dựa trên tiếng Anh. Ví dụ: ３丁目 sẽ trở thành 3-chome.
- Xin lưu ý rằng tính năng xem trước chưa hỗ trợ tiếng Nhật
- Nếu không có phiên bản latin hoá của ngôn ngữ, 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 phải tiếng Anh
Mọi ký tự Latin không phải 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": ð, ò, ó, ô, õ, ö, ø, ō, ŏ, ő, ơ, ṍ, ṏ, ṑ, ṓ, ọ, ỏ, ố, ồ, ổ, ỗ, ộ, ớ, ờ, ở, ỡ và ợ. Ví dụ:
Calle de Ruiz de Alarcón đổi thành Calle de Ruiz de Alarcon
Ví dụ về việc chuyển đổi địa chỉ
Ví dụ sau đây cho thấy phản hồi xác thực từ 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 lựa 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 Xem trước của Dịch vụ, nhưng chúng tôi sẽ xem xét các yêu cầu ở các giai đoạn phát triển này theo từng trường hợp.
Hãy sử dụng các đề xuất sau đây cho các phiên bản trước khi phát hành công khai:
Các tính năng trước giai đoạn phát hành rộng rãi không thuộc phạm vi áp dụng của Thoả thuận mức độ dịch vụ (SLA) của Google Maps Platform.
Sử dụng cơ chế dự phòng, đặc biệt là nếu bạn đang sử dụng một tính năng trước khi phát hành công khai trong môi trường sản xuất. Một số ví dụ về tình huống dự phòng: vượt quá hạn mức, độ trễ và mã phản hồi 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ó. Hãy nhớ thêm những thông tin sau vào 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 thêm, 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 chi tiết cụ thể về trường hợp sử dụng của bạn và các cơ hội mới mà tính năng này sẽ mang lại.
Đối với ý kiến phản hồi này hoặc bất kỳ câu hỏi nào khác về các tính năng, hãy gửi email đến Đường dây nóng xác minh địa chỉ: address-validation-hotline@google.com.