현지화된 값 요청

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

    RPC

    const (fieldMask = "routes.localized_values")

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