Routes API 빠른 참조

Routes API는 두 가지 메서드를 제공하는 웹 서비스입니다. Compute Routes는 선택적 중간 경유지를 포함하여 두 위치 간의 경로를 반환하고, Compute Route Matrix는 출발지와 목적지 조합(최대 625개 경로 요소)의 이동 거리와 시간을 반환합니다.

Routes API: 주요 정보

  • 제품: Routes API
  • 다른 이름: Routes API v2, Compute Routes, Compute Route Matrix
  • 카테고리: 경로
  • 플랫폼: 웹 서비스(REST)
  • 실행 위치: 서버(백엔드 코드)
  • 출시 단계: GA
  • 수명 주기: 활성
  • 개요: Routes API 개요
  • 신청 가능 지역: 전 세계 이륜차 경로, 친환경 경로 탐색, 통행료 계산은 지원되는 국가 및 도시로 제한되며, 자체 CLDR 코드가 있는 종속 지역은 목록에 없는 한 지원되지 않습니다. 유럽 경제 지역(EEA) 청구서 수신 주소의 경우 https://developers.google.com/maps/comms/eea/routes의 EEA 약관에 따라 지도와 함께 경로 설명 또는 단계를 사용할 수 없습니다. (보증 범위 세부정보)

Routes API: 사용 시기

다음과 같은 경우 Routes API를 사용하세요.

  • 운전, 도보, 자전거, 이륜차 또는 대중교통을 이용할 때 출발지와 목적지 사이에 경로가 필요하며, 선택적으로 중간 경유지를 포함할 수 있습니다.
  • 한 번의 요청으로 여러 출발지-목적지 쌍의 이동 거리와 시간이 필요한 경우(최대 625개 요소)
  • 예상 통행료(일부 도시), 친환경 경로(일부 지역), 교통정보를 반영한 다중선 또는 대형 차량 경로(제한적으로 제공)가 필요합니다.
  • 기존 Directions API 또는 Distance Matrix API에서 서버 앱을 마이그레이션하는 경우

다음과 같은 경우에는 Routes API를 사용하지 마세요.

  • 전체 차량의 적재 할당과 정지 순서를 최적화해야 합니다. 대신 Route Optimization API를 사용하세요.
  • Android에서 계산된 경로를 따르는 인앱 세부 경로 안내 내비게이션이 필요합니다. 대신 Android용 Navigation SDK를 사용하세요.
  • iOS에서 계산된 경로를 따르는 인앱 세부 경로 안내 내비게이션이 필요합니다. 대신 iOS용 Navigation SDK를 사용하세요.

Routes API: 설정

공식 Routes API 패키지:

  • npm: @googlemaps/routing
  • pypi: google-maps-routing
  • go: cloud.google.com/go/maps
  • maven: com.google.maps:google-maps-routing

Routes API: 흔히 발생하는 실수

  • 문제: 반환되는 필드의 기본 목록이 없습니다. 필드 마스크(X-Goog-FieldMask 헤더 또는 $fields 매개변수)가 없는 요청은 오류를 반환합니다. 해결 방법: 필요한 응답 필드를 나열하는 필드 마스크를 항상 전송합니다. /maps/documentation/routes/choose_fields를 참고하세요.
  • 문제: 프로덕션에서 와일드 카드 필드 마스크(*)를 사용하면 비용과 지연 시간이 증가하며, 새로운 고급 기능이 응답에 추가됨에 따라 비용이 예기치 않게 증가할 수 있습니다. 해결 방법: 개발 중에만 *를 사용하고 프로덕션에서는 필요한 필드만 요청합니다. /maps/documentation/routes/choose_fields를 참고하세요.
  • 문제: 통행료 정보와 연료 소비량은 필드 마스크에 추가하는 것만으로는 반환되지 않습니다. 정식 버전 이후에는 명시적으로 사용 설정해야 합니다. 해결 방법: 필드 마스크 외에 extraComputations 배열(예: TOLLS, FUEL_CONSUMPTION)을 요청에 추가합니다. /maps/documentation/routes/migrate-routes-preview를 참고하세요.
  • 문제: Compute Route Matrix는 625개의 요소를 허용하지만 routingPreference가 TRAFFIC_AWARE_OPTIMAL인 경우 100개의 요소만 허용합니다. 해결 방법: TRAFFIC_AWARE_OPTIMAL를 사용할 때 출발지 x 목적지를 100개 이하로 유지하거나 요청을 분할합니다. /maps/documentation/routes/compute_route_matrix를 참고하세요.

Routes API로 할 수 있는 작업

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