Route Optimization API 빠른 참조

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: 설정

공식 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: 일반적인 실수

  • 문제: 차단 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로 할 수 있는 작업

각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.