Khi sử dụng Address Validation API, 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 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 một địa chỉ có nguồn gốc từ một 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 cũng như 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 lô hàng đến và đi từ một quốc gia sử dụng ngôn ngữ khác với ngôn ngữ của địa chỉ được 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 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 dựa trên tiếng Anh trong khi xác minh địa chỉ đến Bảo tàng Prado:
curl -X POST -d '{
"address": {
"region_code" : "ES",
"address_lines": ["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 một cách tốt nhất có thể. Bạn không thể 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 như trường address, ngoại trừ những trường hợp sau:
- Không có trường
ConfirmationLevel - Không có trường
unconfirmedComponentTypes
Cải thiện chất lượng của lượt chuyển đổi địa chỉ tại Nhật Bản
Khi gửi địa chỉ bằng tiếng Nhật để chuyển đổi sang tiếng Anh, hãy thêm dấu cách hoặc dấu phân cách (ví dụ: "-") giữa các phần sau của địa chỉ:
- Số toà nhà (cơ sở) và tên toà nhà.
- Số nhà (cơ sở) và số nhà phụ / số căn hộ.
- Tên toà nhà và địa chỉ phụ.
Ví dụ:
- 東京都渋谷区渋谷 ３−２１−３ 渋谷ストリーム ５階 (Đề xuất)
- 東京都渋谷区渋谷３−２１−３渋谷ストリーム５階 (Không nên dùng)
Ví dụ khi không có tên toà nhà:
- 東京都渋谷区渋谷３丁目２１−３ ５階 (Đề xuất)
- 東京都渋谷区渋谷３丁目２１−３−５階 (Đề xuất)
- 東京都渋谷区渋谷３丁目２１−３５階 (Không nên dùng)
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ẻ. 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ơ đồ sau đây minh hoạ cách chuyển đổi địa chỉ Calle Dueñas, 5, 41003 Sevilla, España sang tiếng Anh.
Đố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ẽ sử dụng quy trình được mô tả trong các phần sau.
Sử dụng tiếng Anh đã dịch đầy đủ khi 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. Đây thường là trường hợp của các thành phần địa chỉ lớn hơn, chẳng hạn như country và administrative_area_level_1.
Sử dụng phương pháp Latinh hoá 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 chữ La-tinh bằng cách sử dụng phương pháp phiên âm.
- 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ự trong 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 bảng chữ cái 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 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 La-tinh hoá của tiếng Nhật.
Mọi ký tự không phải tiếng Anh, không phải tiếng Latinh đều được thay thế bằng ký tự Latinh dựa trên tiếng Anh. Ví dụ: ３丁目 trở thành 3-chome.
- Xin lưu ý rằng tiếng Nhật chưa được hỗ trợ cho bản xem trước
- Nếu không có phiên bản Latinh 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ự La-tinh không phải tiếng Anh đều được thay thế bằng ký tự tương đương bằng tiếng Anh. 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 trở thành Calle de Ruiz de Alarcon
Ví dụ về việc chuyển đổi địa chỉ
Ví dụ sau đây cho thấy một phản hồi xác thực từ yêu cầu về Palacio de las Dueñas ở Tây Ban Nha, với englishLatinAddress được in đậm. Yêu cầu này đã sử dụng trường returnEnglishLatinAddress trong tham số languageOptions trong dữ liệu đầ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 Xem trước, tính năng hoặc chức năng của Dịch vụ, nhưng chúng tôi sẽ xem xét các yêu cầu ở những 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 này cho phiên bản trước GA:
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 SLA của Nền tảng Google Maps.
Sử dụng cơ chế dự phòng, đặc biệt nếu bạn đang sử dụng một tính năng trước GA trong môi trường sản xuất. Một số ví dụ về các trường hợp dự phòng là: 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 so với hành vi hiện có.
Bạn có thể sử dụng trình theo dõi vấn đề để 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ớ cung cấp những thông tin sau 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 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 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 có thể 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 thực địa chỉ: address-validation-hotline@google.com.