Routes API는 경로, 거리, 이동 시간 계산 성능을 개선하므로 현재 Directions API 및 Distance Matrix API를 사용하는 앱을 교체할 가치가 있습니다. Routes API의 기능 대부분은 Directions API 및 Distance Matrix API와 모두 호환됩니다.
이 가이드를 통해 Routes API가 대체하는 제품과 비교하여 Routes API의 주요 차이점과 필요한 변경사항을 처리하는 방법을 알아보세요. 다른 Routes API 기능에 대한 자세한 내용은 제품 개요를 참고하세요.
주요 개선사항
이 섹션에서는 앱에서 Routes API를 사용할 때 기대할 수 있는 개선 사항을 설명합니다.
요청 한도 증가
| Routes API |
|
| Distance Matrix API |
|
더 빠른 요청 응답
컴퓨팅 경로 매트릭스 기능은 다음과 같은 지연 시간 개선을 제공합니다.
- 전체 행렬이 계산되기 전에 응답의 스트리밍 요소 수신
- 필드 마스크를 사용하여 응답 세부정보를 맞춤설정하여 필요한 데이터만 요청합니다. 이는 비용 절감에도 도움이 되는 권장사항입니다.
- 트래픽에 대한 경로 계산이 향상되어 데이터 품질과 응답 시간 간에 절충할 수 있습니다.
라우팅 개선사항
컴퓨팅 경로 기능은 다음과 같은 라우팅 개선사항을 제공합니다.
- 거리, 도착예정시간 외에 통행료 정보
- 이륜차 경로.
- 안전을 위해 경유 경유지를 확인합니다.
- 경유지의 이동 방향과 도로변을 설정하여 도착예정시간의 정확성 개선
필요한 데이터만 요청
이제 반환할 필드를 지정하여 처리 시간과 청구 요금을 줄일 수 있습니다.
| Routes API | 요청은 필드 마스크를 사용하여 응답에 반환될 필드를 지정해야 합니다. 필드 마스킹을 사용하면 불필요한 데이터를 요청하지 않으므로 불필요한 처리 시간과 요금이 청구되지 않습니다.
자세한 내용은 반환할 필드 선택을 참고하세요. |
| Directions API Distance Matrix API |
앱에 필드 필드가 꼭 필요하지 않더라도 기본 필드 목록을 반환합니다. 이로 인해 불필요한 처리 시간 및 요금이 발생할 수 있습니다. |
교통정보에 대한 향상된 경로 계산
Routes API는 트래픽 정보를 요청할 때 응답 지연 시간과 데이터 품질 사이에서 균형을 맞추는 데 사용할 수 있는 세 가지 라우팅 환경설정을 지원합니다.
자세한 내용은 품질 및 지연 시간 구성을 참고하세요.
TRAFFIC_UNAWARE (기본값) |
실시간 교통정보가 아닌 평균 시간과 무관한 교통정보 데이터를 사용하여 경로를 계산하므로 응답 지연 시간이 가장 짧습니다. 이 설정은 Directions API 및 Distance Matrix API에서 교통정보를 사용하지 않는 경우와 동일합니다. |
TRAFFIC_AWARE (신규) |
성능에 최적화된 실시간 트래픽 품질로 지연 시간 단축 TRAFFIC_AWARE_OPTIMAL와 달리 이 설정은 지연 시간을 크게 줄이기 위해 최적화를 적용합니다.
이 설정은 Routes API에도 새로 도입되었으며 Directions API 또는 Distance Matrix API에 동등한 항목이 없습니다.
|
TRAFFIC_AWARE_OPTIMAL |
우수한 품질의 종합적인 트래픽 데이터 이 설정은 지연 시간이 가장 길며 Directions API 및 Distance Matrix API의 departure_time 설정과 동일합니다. 이 환경설정은 maps.google.com 및 Google 지도 모바일 앱에서 사용하는 모드와 동일합니다. |
경로 계산 비교
다음 표에서는 Routes API, Directions API, Distance Matrix API 서비스 간의 경로 옵션을 비교합니다.
| 교통정보 옵션 | Routes API | Directions API Distance Matrix API |
지연 시간 |
|---|---|---|---|
| 실시간 교통정보 없음 | TRAFFIC_UNAWARE |
departure_time 속성이 설정되지 않음 |
3가지 모드 중 가장 빠른 지연 시간 |
| 실시간 교통상황 적용됨 | TRAFFIC_AWARE |
- 동등한 보고서 없음 | Routes API에서 새 모드를 추가합니다.
|
| 종합적인 고품질 실시간 트래픽 데이터 적용 | TRAFFIC_AWARE_OPTIMAL |
departure_time 속성이 설정됨 |
maps.google.com 및 Google 지도 모바일 앱에서 사용하는 모드와 동일합니다. Compute Route Matrix의 경우 요청의 요소 수 (출발지 수 × 목적지 수)는 100을 초과할 수 없습니다. |
주요 차이점
이 섹션에서는 Routes API와 API가 대체하는 서비스의 주요 차이점과 기존 앱에서 이러한 서비스에서 마이그레이션할 때 이러한 차이점을 해결하는 방법을 설명합니다.
두 개가 아닌 하나의 서비스 호출
| Routes API | 앱이 Compute Routes 및 Compute Route Matrix를 사용할 수 있도록 API 콘솔에서 하나의 서비스만 사용 설정합니다.
자세한 내용은 Google API 콘솔에서 설정을 참고하세요. |
| Directions API Distance Matrix API |
API 콘솔에서 Directions API와 Distance Matrix API를 별도의 서비스로 사용 설정합니다. |
HTTPS POST 요청 사용
| Routes API | HTTP POST 요청의 일부로 요청 본문 또는 헤더에 매개변수를 전달합니다. 예를 보려면 다음을 참고하세요. - 경로 계산 - 경로 행렬 계산 |
| Directions API Distance Matrix API |
HTTP GET 요청을 사용하여 URL 매개변수를 전달합니다. |
ETA 응답 차이
Routes API는 ETA를 반환하고 아래 표에 표시된 대로 Directions API 및 Distance Matrix API 서비스와는 다른 duration 응답 속성을 사용합니다.
| 도착예정시간 유형 | Routes API | Directions API Distance Matrix API |
|---|---|---|
| 교통체증을 알 수 없으며 시간과 무관한 도착예정시간입니다. |
|
요청에 설정되지 않은
|
| 실시간 교통정보를 고려한 도착예정시간. |
|
요청에서
|
다중선 경유지
이 서비스를 사용하면 더 이상 위도/경도 좌표를 다중선 경유지로 변환할 필요가 없습니다. 이 서비스는 POST 요청 본문을 지원하므로 더 이상 URL 문자열 제한의 영향을 받지 않습니다. Distance Matrix API의 일부 사용자는 위도/경도 지점을 다중선 경유지로 변환하여 요청 제한 문제를 해결했습니다.
형식이 지정된 주소 (역 지오코딩)
Routes API는 응답에 형식이 지정된 주소를 제공하지 않았습니다. 형식이 지정된 주소를 가져오려면 이 사용 사례에 맞게 빌드되었으며 고품질 결과를 제공하는 Geocoding API를 사용하세요.
사용 가능한 이동 수단
Directions API의 경우와 마찬가지로 경로 요청에 이동수단이 지정되지 않은 경우 Routes API는 DRIVE를 기본 모드로 사용합니다. 하지만 요청에서 경로의 이동 수단을 지정하는 경우 Routes API는 요청의 대체 옵션으로 사용 가능한 이동 수단의 배열을 반환하지 않습니다. 사용 사례에서 이 기능을 사용하는 경우 후속 조치를 취할 수 있도록 기능 사용 방법을 설명하는 문제를 제출하세요.
응답 형식인 XML
Routes API는 XML을 응답 형식으로 제공하지 않습니다. 용도에 맞는 다양한 JSON-XML 변환기를 온라인에서 찾을 수 있습니다.