Giá trị phản hồi đã bản địa hoá là một trường phản hồi bổ sung cung cấp văn bản đã bản địa hoá cho các giá trị tham số được trả về. Văn bản đã bản địa hoá được cung cấp cho thời lượng chuyến đi, quãng đường và hệ thống đơn vị (theo hệ mét hoặc hệ đo lường Anh). Bạn yêu cầu các giá trị được bản địa hoá bằng mặt nạ trường, đồng thời có thể chỉ định ngôn ngữ và hệ thống đơn vị quảng cáo hoặc sử dụng các giá trị do API suy ra. Để biết thông tin chi tiết, hãy xem phần LocalizedValues.
Ví dụ: nếu bạn chỉ định mã ngôn ngữ cho tiếng Đức (de) và hệ Anh
đơn vị, bạn sẽ nhận được giá trị của distanceMeters
là 49889,7,
mà còn bản địa hoá văn bản cung cấp số liệu đo khoảng cách bằng tiếng Đức và
đơn vị hệ đo lường của Hoa Kỳ, nên "31 Meile".
Dưới đây là ví dụ về những gì bạn sẽ thấy đối với các giá trị đã bản địa hoá:
{ "localized_values": { "distance": { "text": "31,0 Meile/n" }, "duration": { "text": 38 Minuten}. "static_duration": { "text": 36 Minuten}. } }
Nếu bạn không chỉ định ngôn ngữ hoặc hệ thống đơn vị, API sẽ suy luận ngôn ngữ và đơn vị như sau:
- Phương thức
ComputeRoutes
dự đoán vị trí và khoảng cách đơn vị từ điểm tham chiếu gốc. Vì vậy, đối với yêu cầu định tuyến ở Hoa Kỳ, API suy raen-US
ngôn ngữ vàIMPERIAL
đơn vị. - Phương thức
ComputeRouteMatrix
mặc định là ngôn ngữ "en-US" và đơn vị METRIC.
Cách yêu cầu các giá trị đã bản địa hoá
Để đưa các giá trị đã bản địa hoá vào phản hồi, bạn cần làm như sau:
Yêu cầu các giá trị đã bản địa hoá trong mặt nạ trường. Ví dụ:
Kiến trúc chuyển trạng thái đại diện (REST)
-H X-Goog-FieldMask: routes.localized_values
RPC
const (fieldMask = "routes.localized_values")
Nếu bạn muốn các giá trị được bản địa hoá sang một hệ thống đơn vị hoặc ngôn ngữ cụ thể, chỉ định mã ngôn ngữ và hệ thống đơn vị:
"languageCode": "language_code", "units": "METRIC | IMPERIAL",
Để biết thêm thông tin, hãy xem Hỗ trợ ngôn ngữ.
Ví dụ: đoạn mã này chỉ định ngôn ngữ là tiếng Đức (de) và Đơn vị METRIC:
"languageCode": "de", "units": "METRIC",
Yêu cầu mẫu
curl -X POST -d '{ "origin": { "location": { "latLng": { "latitude": 37.7873146, "longitude": -122.4159327 } } }, "destination": { "location": { "latLng": { "latitude": 37.7621008, "longitude": -122.4382503 } } }, "travelMode": "DRIVE", "computeAlternativeRoutes": true, "languageCode": "de", "units": "METRIC" }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.localized_values' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Ví dụ về phản hồi
Phản hồi trả về các giá trị đã bản địa hoá cho các trường distance
, duration
và staticDuration
:
{ "localizedValues": { "distance": { "text": "15,5 km" }, "duration": { "text": "16 Minuten" }, "staticDuration": { "text": "16 Minuten" } } }