Routes API는 2022년 9월에 공개 미리보기 (GA 이전)로 출시되었습니다. GA 이전 버전 제품 및 서비스에는 Google Maps Platform 서비스별 약관이 적용됩니다. 자세한 내용은 출시 단계 설명을 참조하세요.
이 섹션에서는 앱을 미리보기 출시 버전에서 GA 출시 버전으로 이전하는 방법을 설명합니다.
GA 출시에 새로운 기능이 추가됨
GA 출시에는 미리보기에 포함되지 않은 다음과 같은 새로운 기능이 추가되었습니다.
이제 장소 ID 및 위도/경도 좌표와 함께 다음을 사용하여 GA 버전에서 위치를 지정할 수 있습니다.
주소 문자열 ('시카고, 일리노이' 또는 '다윈, 노던 티에리, 오스트레일리아')
주소 문자열은 사용자가 주소를 입력하는 방법입니다. 하지만 {product_name}은 먼저 주소 문자열을 내부적으로 지오코딩하여 위도/경도 좌표로 변환해야 경로를 계산할 수 있습니다.
또한 특정 지리적 지역의 지오코딩된 결과를 반환하도록 지정할 수 있는
regionCode
요청 매개변수 지원이 추가되었습니다.-
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
를 다음 값 중 하나 이상을 포함하도록 설정해야 합니다.