현지화된 값 요청

현지화된 응답 값은 반환된 매개변수 값에 대해 현지화된 텍스트를 제공하는 추가 응답 필드입니다. 이동 시간, 거리 및 단위 체계 (미터법 또는 야드파운드법)에 대해 현지화된 텍스트가 제공됩니다. 필드 마스크를 사용하여 현지화된 값을 요청하며, 언어와 단위 체계를 지정하거나 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. 필드 마스크에 현지화된 값을 요청합니다. 예를 들면 다음과 같습니다.

   REST

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