ขอค่าภาษาท้องถิ่น

ค่าการตอบกลับที่แปลแล้วคือช่องการตอบกลับเพิ่มเติมที่มีข้อความที่แปลแล้วสำหรับค่าพารามิเตอร์ที่แสดงผล ข้อความที่แปลแล้วจะระบุระยะเวลาการเดินทาง ระยะทาง และหน่วย (เมตริกหรืออิมพีเรียล) คุณจะขอค่าที่แปลโดยใช้ฟิลด์มาสก์ และสามารถระบุภาษาและระบบหน่วยหรือใช้ค่าที่อนุมานโดย 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

วิธีขอค่าที่แปล

หากต้องการรวมค่าที่แปลไว้ในคำตอบ คุณจะต้องทำดังนี้

1. ขอค่าที่แปลในมาสก์ฟิลด์ เช่น

   พัก

   -H X-Goog-FieldMask: routes.localized_values

   RPC

   const (fieldMask = "routes.localized_values")

2. หากต้องการค่าที่แปลแล้วในระบบภาษาหรือหน่วยใดหน่วยหนึ่ง ให้ระบุรหัสภาษาและระบบหน่วยดังนี้

   "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"
        }
    }
}