Routes API는 2022년 9월에 공개 미리보기 (GA 이전)로 출시되었습니다. GA 이전 버전 제품 또는 서비스에는 Google Maps Platform 서비스별 약관이 적용됩니다. 자세한 내용은 출시 단계 설명을 참조하세요.
이 섹션에서는 미리보기 버전에서 GA 버전으로 앱을 이전하는 방법을 설명합니다.
GA 버전에 추가된 새로운 기능
GA 출시에는 미리보기에 포함되지 않은 다음과 같은 새로운 기능이 추가됩니다.
이제 GA 버전에서 장소 ID 및 위도/경도 좌표와 함께 다음을 사용하여 위치를 지정할 수 있습니다.
주소 문자열 ('Chicago, IL' 또는 'Darwin, NT, Australia')
주소 문자열은 사용자가 주소를 입력하는 방법인 경우가 많습니다. 그러나 {product_name}은(는) 먼저 주소 문자열을 내부적으로 지오코딩하여 위도/경도 좌표로 변환해야 경로를 계산할 수 있습니다.
또한
regionCode요청 매개변수에 대한 지원이 추가되어 특정 지리적 지역의 지오코딩된 결과를 반환하도록 지정할 수 있습니다.-
Plus Code는 실제 주소가 없는 사람이나 장소의 상세 주소와 같습니다. Plus Code는 도로 이름과 숫자가 포함된 주소 대신 위도와 경도를 기반으로 하며 숫자와 문자로 표시됩니다.
이제 컴퓨팅 경로 응답에
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에 다음 값 중 하나 이상을 포함하도록 설정해야 합니다.