Routes API는 2022년 9월에 공개 미리보기 (GA 이전)로 출시되었습니다. GA 이전 버전 제품 및 서비스에는 Google Maps Platform 서비스별 약관이 적용됩니다. 자세한 내용은 출시 단계 설명을 참조하세요.
이 섹션에서는 미리보기 출시에서 GA 버전으로 앱을 이전하는 방법을 설명합니다.
GA 버전에 추가된 새로운 기능
GA 버전에는 미리보기에 포함되지 않은 다음과 같은 새로운 기능이 추가되었습니다.
이제 다음을 사용하여 GA 버전에서 장소 ID 및 위도/경도 좌표와 함께 위치를 지정할 수 있습니다.
주소 문자열 ('Chicago, IL' 또는 'Darwin, NT, Australia')
주소 문자열은 사용자가 주소를 입력하는 방법인 경우가 많습니다. 하지만 {product_name}에서 경로를 계산하려면 먼저 주소 문자열을 내부적으로 지오코딩하여 위도/경도 좌표로 변환해야 합니다.
또한
regionCode
요청 매개변수에 대한 지원이 추가되어 특정 지역의 지오코딩된 결과를 반환하도록 지정할 수 있습니다.-
플러스 코드는 실제 주소가 없는 사람 또는 장소의 상세 주소와 같습니다. Plus Code는 거리 이름과 숫자가 포함된 주소 대신 위도와 경도를 기반으로 하며 숫자와 문자로 표시됩니다.
이제 compute 경로 응답에
geocodingResults
배열이 포함됩니다. API는 주소 문자열 또는 플러스 코드로 지정된 요청의 모든 위치 (출발지, 목적지 또는 중간 경유지)에 대해 장소 ID 조회를 수행합니다. 이 배열의 각 요소에는 위치에 해당하는 장소 ID와 위치에 대한 추가 메타데이터가 포함됩니다. 장소 ID 또는 위도/경도 좌표로 지정된 요청에서 위치는 무시됩니다.
기존 미리보기 기능의 변경사항
이제 요청에 새 배열 extraComputations
필드를 추가하여 GA에서 다음 기능을 명시적으로 사용 설정해야 합니다.
미리보기 출시에서는 필드 마스크를 사용하여 응답에서 이러한 기능에 관한 정보를 반환하도록 지정했습니다. 이제 다음 두 가지 작업을 모두 수행해야 합니다.
- 이러한 기능을 사용 설정하려면 새로운
extraComputations
배열 요청 매개변수를 설정하세요. - 응답에 정보를 반환하려면 지정할 필드 마스크를 설정합니다.
알아두어야 할 사항은 무엇인가요?
다음 필드는 extraComputations
를 설정하여 명시적으로 사용 설정하지 않는 한 더 이상 computeRouteMatrix 응답에 포함되지 않습니다.
travelAdvisory.tollInfo
(통행료 정보)
다음 필드는 extraComputations
를 설정하여 명시적으로 사용 설정하지 않는 한 더 이상 computeRoutes 응답에 포함되지 않습니다.
routes.legs.travelAdvisory.tollInfo
(통행료 정보)routes.travelAdvisory.tollInfo
(통행료 정보)routes.travelAdvisory.fuelConsumptionMicroliters
(연료 소비량)routes.travelAdvisory.speedReadingIntervals
(다중선의 교통정보)routes.legs.travelAdvisory.speedReadingIntervals
(다중선의 교통정보)
어떤 조치를 취해야 하나요?
다중선에서 요금 정보, 연료 소비 또는 교통량에 대한 응답 필드를 수신하려면
새 요청 배열 필드 extraComputations
에 다음 값 중 하나 이상을
포함하도록 설정해야 합니다.