현지화된 응답 값은 반환된 매개변수 값에 대해 현지화된 텍스트를 제공하는 추가 응답 필드입니다. 현지화된 텍스트는 이동 시간, 거리, 단위 체계 (미터법 또는 야드파운드법)입니다. 필드 마스크를 사용하여 현지화된 값을 요청하고 언어 및 단위 체계를 지정하거나 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 단위가 포함됩니다.
현지화된 값 요청
응답에 현지화된 값을 포함하려면 다음을 실행해야 합니다.
필드 마스크에 현지화된 값을 요청합니다. 예를 들면 다음과 같습니다.
REST
-H X-Goog-FieldMask: routes.localized_values
RPC
const (fieldMask = "routes.localized_values")
특정 언어나 단위 체계로 현지화된 값을 원한다면 다음과 같이 언어 코드와 단위 체계를 지정합니다.
"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.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" } } }