미리보기 버전에서 이전

Routes API는 2022년 9월에 공개 미리보기 (GA 이전)로 출시되었습니다. GA 이전 버전 제품 및 서비스에는 Google Maps Platform 서비스별 약관이 적용됩니다. 자세한 내용은 출시 단계 설명을 참조하세요.

이 섹션에서는 앱을 미리보기 출시 버전에서 GA 출시 버전으로 이전하는 방법을 설명합니다.

GA 출시에 새로운 기능이 추가됨

GA 출시에는 미리보기에 포함되지 않은 다음과 같은 새로운 기능이 추가되었습니다.

  • 이제 장소 ID 및 위도/경도 좌표와 함께 다음을 사용하여 GA 버전에서 위치를 지정할 수 있습니다.

    • 주소 문자열 ('시카고, 일리노이' 또는 '다윈, 노던 티에리, 오스트레일리아')

      주소 문자열은 사용자가 주소를 입력하는 방법입니다. 하지만 {product_name}은 먼저 주소 문자열을 내부적으로 지오코딩하여 위도/경도 좌표로 변환해야 경로를 계산할 수 있습니다.

      또한 특정 지리적 지역의 지오코딩된 결과를 반환하도록 지정할 수 있는 regionCode 요청 매개변수 지원이 추가되었습니다.

    • Plus 코드

      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를 다음 값 중 하나 이상을 포함하도록 설정해야 합니다.

  • 통행료 정보를 수신하려면 새 extraComputations 배열 필드를 "TOLLS"로 설정합니다.

  • 연료 소비량을 수신하려면 새 extraComputations 배열 필드를 "FUEL_CONSUMPTION"로 설정합니다.

  • 다중선의 교통정보를 수신하려면 새 extraComputations 배열 필드를 "TRAFFIC_ON_POLYLINE"로 설정합니다.