ค่าการตอบกลับที่แปลแล้วคือช่องการตอบกลับเพิ่มเติมที่มีข้อความที่แปลแล้วสำหรับค่าพารามิเตอร์ที่แสดงผล ข้อความที่แปลแล้วจะระบุระยะเวลาการเดินทาง ระยะทาง และหน่วย (เมตริกหรืออิมพีเรียล) คุณจะขอค่าที่แปลโดยใช้ฟิลด์มาสก์ และสามารถระบุภาษาและระบบหน่วยหรือใช้ค่าที่อนุมานโดย API ได้ โปรดดูรายละเอียดที่ LocalizedValues
เช่น หากคุณระบุรหัสภาษาสำหรับหน่วยภาษาเยอรมัน (de) และหน่วยอิมพีเรียล คุณจะได้รับค่าสำหรับ distanceMeters
เท่ากับ 49889.7 แต่มีข้อความที่แปลแล้วซึ่งมีการวัดระยะทางเป็นหน่วยเยอรมันและอิมพีเรียลด้วย เช่น "31 Meile"
นี่คือตัวอย่างของสิ่งที่คุณจะเห็นสำหรับค่าที่แปลแล้ว
{ "localized_values": { "distance": { "text": "31,0 Meile/n" }, "duration": { "text": 38 Minuten}. "static_duration": { "text": 36 Minuten}. } }
หากคุณไม่ระบุภาษาหรือระบบหน่วย API จะอนุมานภาษาและหน่วยดังนี้
- เมธอด
ComputeRoutes
จะอนุมานตำแหน่งและหน่วยระยะทางจากจุดอ้างอิงต้นทาง ดังนั้นสำหรับคำขอการกำหนดเส้นทางในสหรัฐอเมริกา API จะอนุมานภาษาen-US
และIMPERIAL
หน่วย - เมธอด
ComputeRouteMatrix
มีค่าเริ่มต้นเป็นภาษา "en-US" และหน่วย METRIC
วิธีขอค่าที่แปล
หากต้องการรวมค่าที่แปลไว้ในคำตอบ คุณจะต้องทำดังนี้
ขอค่าที่แปลในมาสก์ฟิลด์ เช่น
พัก
-H X-Goog-FieldMask: routes.localized_values
RPC
const (fieldMask = "routes.localized_values")
หากต้องการค่าที่แปลแล้วในระบบภาษาหรือหน่วยใดหน่วยหนึ่ง ให้ระบุรหัสภาษาและระบบหน่วยดังนี้
"languageCode": "language_code", "units": "METRIC | IMPERIAL",
ดูข้อมูลเพิ่มเติมได้ที่การรองรับภาษา
ตัวอย่างเช่น ข้อมูลโค้ดนี้ระบุภาษาเป็นหน่วยภาษาเยอรมัน (de) และ METRIC ดังนี้
"languageCode": "de", "units": "METRIC",
ตัวอย่างคำขอ
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'
ตัวอย่างการตอบกลับ
การตอบกลับแสดงค่าที่แปลสำหรับช่อง distance
, duration
และ staticDuration
:
{ "localizedValues": { "distance": { "text": "15,5 km" }, "duration": { "text": "16 Minuten" }, "staticDuration": { "text": "16 Minuten" } } }