현지화된 값 요청

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

청구서 수신 주소가 유럽 경제 지역에 있는 경우 2025년 7월 8일부터 Google Maps Platform EEA 서비스 약관이 서비스 이용에 적용됩니다. 기능은 리전에 따라 다릅니다. 자세히 알아보기

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

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

참고: 예상 기간에 대해 두 가지 값을 얻을 수 있습니다. duration은 지정한 트래픽 모델을 사용하고 staticDuration은 트래픽을 고려하지 않습니다. 따라서 요청된 트래픽 모델이 TRAFFIC_UNAWARE인 경우 이 시간은 동일합니다.

현지화된 값을 요청하려면 다음 단계를 따르세요.

1. ComputeRoutesRequest의 fields 속성에 localizedValues 필드를 추가합니다.
2. 선택적으로 ComputeRoutesRequest의 languageCode 및 units 속성을 사용하여 언어와 단위 시스템을 지정합니다.

다음은 현지화된 값을 요청하는 예입니다.

const requestWithLocalizedValues = {
  origin: 'San Diego, CA',
  destination: 'Ensenada, MX',
  travelMode: 'DRIVING',
  language: 'es',
  units: google.maps.UnitSystem.METRIC,
  fields: ['path', 'localizedValues', 'distanceMeters', 'durationMillis'],
};
  

언어 또는 단위 시스템을 지정하지 않으면 computeRoutes 메서드가 출발지 경유지에서 위치 및 거리 단위를 추론합니다. 따라서 미국에서의 라우팅 요청의 경우 API는 en-US 언어와 IMPERIAL 단위를 추론합니다.

현지화된 값을 읽으려면 route.localizedValues를 사용하세요. 예를 들면 다음과 같습니다.

const localizedValues = route.localizedValues;
const distance = localizedValues.distanceMeters;
const duration = localizedValues.duration;
const durationStatic = localizedValues.staticDuration;