本地化回應值是額外的回應欄位,可為傳回的參數值提供本地化文字。針對行程所需時間、距離和單位系統 (公制) 提供本地化文字。您可以使用欄位遮罩要求本地化值,並指定語言和單位系統,或使用 API 推測的值。詳情請參閱 LocalizedValues。
舉例來說,如果您為德文 (de) 和英制單位指定語言代碼,會取得 49889.7 的 distanceMeters
值,另外也會取得以德文和英制單位表示距離的本地化文字,例如「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」語言和指標單位。
要求本地化值
如要在回應中加入本地化值,您必須執行下列操作:
要求欄位遮罩中的本地化值。例如:
REST
-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" } } }