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.googleapis.com - 인증: API 키, OAuth 2.0, 서비스 계정
- 시작하기: Routes API 설정
- 참조: Routes API 참조
- 가격 책정: Routes API 사용량 및 결제
- 정책: Routes API 정책
- 출시 노트: 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: 관련 상품
- 대체: Directions API, Distance Matrix API
- 함께 자주 사용되는 API: Android용 Navigation SDK, iOS용 Navigation SDK, Route Optimization API, Geocoding API, Places API(신규)
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로 할 수 있는 작업
각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.
- 두 개 이상의 위도/경도 좌표 간의 경로를 경로의 각 단계에 대한 일련의 좌표로 반환합니다.
- 두 개 이상의 위도/경도 좌표 집합 간의 경로를 경로를 따라 이동하는 단계에 대한 일련의 이동 설명으로 반환합니다.
- 두 개 이상의 위도/경도 좌표 집합 사이의 경로를 따라 각 단계 사이의 거리를 반환합니다.
- 두 개 이상의 위도/경도 좌표 집합 간 경로를 따라 각 단계 사이의 이동 시간을 반환합니다.
- 두 개 이상의 위도/경도 좌표 집합 간 경로의 각 단계 사이에 인코딩된 다중선을 반환합니다.
- 두 개 이상의 위도/경도 좌표 집합 간 경로의 거리를 반환합니다.
- 두 개 이상의 위도/경도 좌표 집합 간 경로의 이동 시간을 반환합니다.
- 두 개 이상의 위도/경도 좌표 집합 간 경로에 대해 인코딩된 다중선을 반환합니다.
- 두 개 이상의 위도/경도 좌표 집합 간 경로의 통행료 정보를 반환합니다.
- 경로 요청에 대한 이동 수단(운전, 대중교통, 도보, 오토바이)을 지정합니다. 참고: Routes API 웹 서비스(computeRoutes)에서 RouteTravelMode(DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT 또는 routeModifiers.vehicleInfo가 포함된 TRUCK)를 사용하여 HTTP POST JSON 본문에 travelMode를 전달하고 기존 GET 모드 쿼리 매개변수 대신 필수 X-Goog-FieldMask 헤더를 포함합니다. Maps JavaScript API Routes 라이브러리에서 ComputeRoutesRequest에 travelMode 및 필드를 전달합니다.
- 경로 요청의 정류장 또는 통과 지점을 지정합니다.
- 경로 요청에서 교통정보 데이터가 사용되는 방식을 지정합니다.
- 경로 요청에서 고속도로나 유료 도로와 같이 피해야 할 지형지물을 지정합니다.
- 경로를 따라 경유지를 설정합니다.
- 경로를 따라 중간 경유지를 설정합니다.
- 경로가 통과할 지점을 설정합니다.
- 경로의 차량 방향 및 도로 측면을 지정합니다.
- 경로의 경유지 순서를 최적화합니다.
- 경로 요청에 친환경 경로 탐색을 지정합니다. 미리보기
- 경로 요청에 더 짧은 거리 또는 대체 경로를 지정합니다. 참고: Routes API에서 더 짧은 거리의 참조 경로(SHORTER_DISTANCE)를 요청하는 것은 실험 단계이지만 대체 경로(computeAlternativeRoutes)를 요청하는 것은 정식 버전입니다.
- 여러 출발지와 목적지 간의 경로 행렬에 대한 거리를 반환합니다.
- 여러 출발지와 목적지 간의 경로 행렬에 대한 이동 시간을 반환합니다.
- 여러 출발지와 목적지 간의 경로 행렬에 대한 통행료 정보를 반환합니다.
- 경로 매트릭스 요청의 이동 수단(운전, 대중교통, 도보, 오토바이)을 지정합니다. 참고: Routes API 웹 서비스(computeRouteMatrix)에서 RouteTravelMode(DRIVE, TWO_WHEELER, WALK, TRANSIT 또는 TRUCK(origins[].routeModifiers.vehicleInfo 사용), BICYCLE은 경로 매트릭스에 지원되지 않음)를 사용하여 HTTP POST JSON 본문에 travelMode를 전달하고 필수 X-Goog-FieldMask 헤더를 포함합니다. Maps JavaScript API Routes 라이브러리에서 ComputeRouteMatrixRequest에 travelMode 및 필드를 전달합니다.