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

นักพัฒนาแอปในเขตเศรษฐกิจยุโรป (EEA)

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

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

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

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

    REST

    -H X-Goog-FieldMask: routes.localizedValues

    RPC

    const (fieldMask = "routes.localizedValues")

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

    "languageCode": "language_code",
"units": "METRIC | IMPERIAL",

    ตัวอย่างเช่น ข้อมูลโค้ดนี้ระบุภาษาเป็นเยอรมัน (de) และหน่วยเป็นเมตริก 

    "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.localizedValues' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

ตัวอย่างการตอบกลับ

การตอบกลับจะแสดงค่าที่แปลแล้วสำหรับฟิลด์ distance, duration และ staticDuration ดังนี้

{
    "localizedValues": {
        "distance": {
            "text": "15,5 km"
         },
        "duration": {
            "text": "16 Minuten"
        },
        "staticDuration": {
            "text": "16 Minuten"
        }
    }
}