현지화된 값 요청

유럽 경제 지역 (EEA) 개발자

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