현지화된 값 요청

현지화된 응답 값은 반환된 매개변수 값에 현지화된 텍스트를 제공하는 추가 응답 필드입니다. 여행 시간, 거리, 단위 시스템 (미터법 또는 영국식)에 대해 현지화된 텍스트가 제공됩니다. 필드 마스크를 사용하여 현지화된 값을 요청하며, 언어와 단위 시스템을 지정하거나 API에서 추론한 값을 사용할 수 있습니다. 자세한 내용은 LocalizedValues를 참고하세요.

예를 들어 독일어 (de) 및 영국식 단위를 지정하면 distanceMeters 값이 49889.7이 되지만 독일어 및 영국식 단위로 거리를 측정하는 현지화된 텍스트도 표시되므로 '31마일'이 표시됩니다.

다음은 현지화된 값의 예입니다.

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