Route Optimization API는 차량에 작업과 경로를 할당하여 가능 시간대, 차량 용량, 운전자 시간, 비용과 같이 제공된 목표와 제약 조건에 맞게 최적화합니다. REST, gRPC 또는 클라이언트 라이브러리를 통해 호출하면 방문 순서, 배송 할당, 예상 시간, 경로 측정항목이 반환됩니다.
Route Optimization API: 주요 정보
- 제품: Route Optimization API
- 다른 이름: GMPRO
- 카테고리: 경로
- 플랫폼: 웹 서비스(REST)
- 실행 위치: 서버(백엔드 코드)
- 출시 단계: GA
- 수명 주기: 활성
- 개요: Route Optimization API 개요
Route Optimization API: 사용 시기
다음과 같은 경우 Route Optimization API를 사용하세요.
- 가능 시간대, 차량 용량, 운전자 근무 시간, 비용을 고려하여 여러 차량에 배송 또는 작업을 할당해야 합니다.
- 여러 픽업, 배송 또는 약속이 있는 차량 한 대에 가장 적합한 정차 순서가 필요합니다.
injectedFirstSolutionRoutes또는injectedSolutionConstraint를 사용하여 새 주문(예: 주문형 발송)에 대해 활성 경로를 다시 최적화해야 합니다.- Navigation SDK에 전달하려면 최적화된 계획의 각 구간에 대한 경로 토큰이 필요합니다.
다음과 같은 경우에는 Route Optimization API를 사용하지 마세요.
- 운전자가 계획을 어떻게 실행하는지 실시간으로 추적해야 합니다. API는 실시간 차량 경로가 아닌 계획된 다중선을 반환합니다. 대신 Fleet Engine Service를 사용하세요.
- 최적화된 경로를 따라 운전자를 위한 인앱 세부 경로 안내가 필요합니다. 대신 Android용 Navigation SDK를 사용하세요.
- iOS에서 운전자를 위해 최적화된 경로를 따라 인앱 세부 경로 안내가 필요합니다. 대신 iOS용 Navigation SDK를 사용하세요.
Route Optimization API: 설정
- 사용 설정할 서비스:
routeoptimization.googleapis.com - 인증: OAuth 2.0, 서비스 계정
- 시작하기: Route Optimization API 설정
- 참조: Route Optimization API 참조
- 가격 책정: Route Optimization API 사용량 및 결제
- 정책: Route Optimization API 정책
- 출시 노트: Route Optimization API 출시 노트
공식 Route Optimization API 패키지:
- npm:
@googlemaps/routeoptimization - pypi:
google-maps-routeoptimization - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routeoptimization
Route Optimization API: 관련 제품
- 함께 자주 사용되는 제품: Android용 Navigation SDK, iOS용 Navigation SDK, Fleet Engine 서비스, Maps JavaScript API
Route Optimization API: 일반적인 실수
- 문제: 차단
OptimizeTours엔드포인트에 대한 REST 호출의 경우 기본 60초 기한이 60초보다 큰 요청 본문timeout를 재정의합니다. 해결 방법:X-Server-Timeout헤더(초, 's' 접미사 없음)를 설정하여 기한을 연장합니다. 클라이언트 라이브러리 및 gRPC의 기본값은 3,600초입니다. /maps/documentation/route-optimization/timeouts를 참고하세요. - 문제:
timeout및 기한 값은 1,800초로 제한됩니다. 해결 방법:allowLargeDeadlineDespiteInterruptionRisk를true로 설정하여 최대 3, 600초를 허용하고 중단 오류의 위험을 더 높입니다. /maps/documentation/route-optimization/timeouts를 참고하세요. - 문제: 비용 매개변수(예:
costPerHour또는costPerKilometer)가 없으면 최적화 도구는 모든 솔루션을 동일하게 취급합니다. 해결 방법: 비즈니스 비용을 반영하는 차량의 비용 매개변수를 정의합니다. /maps/documentation/route-optimization/make-first-request를 참고하세요. - 문제: API 키로 인증된 요청이 실패합니다. 모든 요청에 OAuth 토큰이 필요합니다. 해결 방법: 애플리케이션 기본 사용자 인증 정보 또는 서비스 계정 등을 통해
https://www.googleapis.com/auth/cloud-platform범위의 OAuth 토큰을 사용합니다. /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token을 참고하세요.
Route Optimization API로 할 수 있는 작업
각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.
- 지정된 경로, 비용, 배송, 차량 제약 조건을 기반으로 최적화된 다중 경유지 배송 계획을 반환합니다.
- 최적화된 배송 계획의 각 경유지에 대한 시작 및 종료 시간을 반환합니다.
- 최적화된 배송 계획의 각 경유지 간 이동, 지연, 휴식, 대기 시간을 반환합니다.
- 최적화된 배송 계획의 각 정류장에서 차량 적재 정보를 반환합니다.
- 최적화된 배송 계획에서 각 배송의 비용 정보를 반환합니다.
- 최적화된 배송 계획의 각 정류장 간 경로에 대해 인코딩된 다중선을 반환합니다.
- 최적화된 배송 계획의 각 정류장 간 경로에 대한 내비게이션 경로 토큰을 반환합니다.
- 최적화된 배송 계획을 위해 집계된 배송, 차량, 비용 측정항목을 반환합니다.
- 여러 정류장이 있는 배송 계획의 시작 및 종료 시간대를 지정합니다.
- 여러 정류장이 있는 배송 계획에서 각 차량의 시작 및 종료 시간, 사용 가능 여부, 위치를 지정합니다.
- 여러 경유지가 있는 배송 계획에서 각 차량의 차량 시간 비용을 지정합니다.
- 다중 경유지 배송 계획의 비용 모델 매개변수를 지정합니다.
- 다중 정차 배송 계획에서 각 배송의 수령 및 배송 기간 제약 조건을 지정합니다.
- 여러 경유지가 있는 배송 계획에 차량 할당을 지정합니다.
- 여러 정류장이 있는 배송 계획에서 각 차량의 적재 한도를 지정합니다.
- 여러 경유지를 거치는 배송 계획에 실시간 교통정보를 고려할지 지정합니다.
- 여러 정류장이 있는 배송 계획 최적화 요청을 일괄 처리하고 응답을 Google Cloud Storage에 기록합니다.
- 배송 전에 주차 시간을 예약하세요.
- 가까운 방문을 우선순위로 두고 연속으로 방문합니다.
- 여러 정류장이 있는 차량 경로에서 유턴을 피합니다. 실험용 참고: 실험용 기능이며 GA 이전 약관 및 제한사항이 적용됩니다.
- 사전 정의된 목표에 맞게 최적화합니다. 실험용 참고: 실험용 기능이며 GA 이전 약관 및 제한사항이 적용됩니다.
- 무거운 배송품을 먼저 배송합니다. 실험용 참고: 실험용 기능이며 GA 이전 약관 및 제한사항이 적용됩니다.