Khi sử dụng API xác thực địa chỉ, bạn có thể yêu cầu 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 tiếng Anh Latinh khi nhận được địa chỉ bắt nguồn 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 dựa trên tiếng Anh và tiếng Anh để chuẩn hóa tất cả các địa chỉ.
- Doanh nghiệp của bạn có thể xử lý việc vận 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ữ của địa chỉ đã 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ỉ với các thành phần tương đương với tiếng Anh đi kèm, 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ỉ tớ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. Xem
Giải quyết ví dụ về lượt chuyển đổi bên dưới để biết thông tin chi tiết. Một
thành phần của địa chỉ ngôn ngữ địa phương được trả về sẽ được chuyển đổi sang tiếng Anh dưới dạng
tốt 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
Địa chỉ
proto như sử dụng trường address, với các ngoại lệ sau:
- Không
ConfirmationLeveltrường - Không
unconfirmedComponentTypestrường
Cách hoạt động của tính năng chuyển đổi địa chỉ
Address Validation API (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 thuộc tính khác
các thành phần 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 đị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ụ này 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
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
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 sang hệ chữ Latinh 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 ký tự Latinh
và không có từ tương đương bằng tiếng Anh cho thành phần địa chỉ, dịch vụ
thay thế các ký tự của ngôn ngữ địa phương không phải bằng tiếng Anh.
Ví dụ:
Calle Dueñastrở thànhCalle Duenas, trong đó ñ là được thay bằng n. - Nếu ngôn ngữ địa phương của địa chỉ không sử dụng chữ Latinh
và không có đoạn tiếng Anh tương đương cho thành phần địa chỉ,
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, không phải Latinh đều được thay thế bằng tiếng Anh
Ký tự Latinh. 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, các thành phần sẽ được đượ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 đều được thay thế bằng ký tự tiếng Anh tương đương. Ví dụ: mỗi ký tự trong số các ký tự sau sẽ được thay thế bằng ký tự "o": Đ, ò, ó, ô, õ, ö, ø, ō, Ö, ő, ơ, ṍ, ṏ, ṑ, ṓ, ọ, ỏ, à, ồ, ổ,ố ỗ, ộ, ớt, ờ, ở, nửa và ợ. 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 từ một yêu cầu đối với 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 thông 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 cung cấp hỗ trợ cho Xem trước các phiên bản, tính năng hoặc chức năng của Dịch vụ, chúng tôi xem xét các yêu cầu tại các giai đoạn phát triển 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 trước giai đoạn phát hành rộng rãi không có trong 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 trước giai đoạn phát hành rộng rãi trong môi trường sản xuất. Một số ví dụ về tính năng dự phòng tình huố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 khi so sánh với hành vi hiện tại.
Bạn có thể sử dụng công cụ theo dõi lỗi để yêu cầu các tính năng mới hoặc đề xuất nội dung sửa đổi đối vớ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:
Đồng thời, hãy mô tả tính năng hoặc hành vi cụ thể mà bạn muốn được thêm vào vì lý do mà bạn cho rằng tầm 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à tính năng này cho phép.
Nếu bạn có ý kiến phản hồi này hoặc 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 để xác thực địa chỉ: address-Valid-line@google.com.