Routes API는 경로, 거리, 이동 시간 계산을 위한 향상된 성능을 제공하므로 현재 Directions API 및 Distance Matrix API를 사용하는 앱을 대체하는 것이 좋습니다. Routes API의 대부분의 기능은 Directions API 및 Distance Matrix API와 모두 하위 호환됩니다.
이 가이드를 사용하여 Routes API와 이를 대체하는 제품의 주요 차이점과 필요한 변경사항을 처리하는 방법을 알아보세요. 다른 Routes API 기능에 관한 자세한 내용은 제품 개요를 참고하세요.
주요 개선사항
이 섹션에서는 앱에서 Routes API를 사용할 때 기대할 수 있는 몇 가지 개선사항을 설명합니다.
요청 한도 증가
| Routes API |
|
| Distance Matrix API |
|
더 빠른 요청 응답
Compute Route Matrix 기능은 다음과 같은 지연 시간 개선을 제공합니다.
- 전체 행렬이 계산되기 전에 응답의 스트리밍 요소를 수신합니다.
- 필드 마스크를 사용하여 응답 세부정보를 맞춤설정하여 필요한 데이터만 요청하는 것이 좋습니다. 이는 비용 절감에도 도움이 되는 권장사항입니다.
- 트래픽에 대한 경로 계산 개선: 데이터 품질과 응답 시간 간에 균형을 맞출 수 있습니다.
라우팅 개선사항
컴퓨팅 경로 기능은 다음과 같은 라우팅 개선사항을 제공합니다.
- 거리 및 도착 예정 시간 외에도 통행료 정보
- 오토바이 경로
- 안전을 위해 중간 기착 지점 웨이포인트의 자격 요건을 충족하세요.
- 경유지의 이동 방향과 도로 측면을 설정하여 도착예정시간 정확성을 개선했습니다.
필요한 데이터만 요청
이제 반환할 필드를 지정하여 처리 시간과 청구 비용을 줄일 수 있습니다.
| 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 속성이 설정되지 않음 |
세 가지 모드 중 가장 빠른 지연 시간입니다. |
| 적용된 실시간 교통상황 | TRAFFIC_AWARE |
- 동등한 보고서 없음 | Routes API에서 추가한 새로운 모드입니다. ETA 품질의 작은 비용으로
|
| 포괄적이고 고품질의 실시간 교통 정보가 적용됨 | TRAFFIC_AWARE_OPTIMAL |
departure_time 속성 집합 |
maps.google.com 및 Google 지도 모바일 앱에서 사용하는 모드와 같습니다. Compute Route Matrix의 경우 요청의 요소 수 (출발지 수 x 목적지 수)가 100을 초과할 수 없습니다. |
주요 차이점
이 섹션에서는 Routes API와 이를 대체하는 서비스 간의 주요 차이점과 기존 앱의 이러한 서비스에서 이전할 때 이러한 차이점을 해결하는 방법을 설명합니다.
두 개가 아닌 하나의 서비스를 호출
| Routes API | 앱이 Compute Routes 및 Compute Route Matrix를 사용하도록 API Console에서 하나의 서비스만 사용 설정합니다.
자세한 내용은 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 응답 속성을 사용합니다.
| ETA 유형 | Routes API | Directions API Distance Matrix API |
|---|---|---|
| 교통정보를 인식하지 않고 시간과 관계없는 도착예정시간 |
|
요청에서
|
| 실시간 교통정보를 고려한 도착예정시간입니다. |
|
요청에서
|
다중선 경유지
이 서비스는 POST 요청 본문을 지원하므로 더 이상 URL 문자열 제한의 영향을 받지 않으므로 더 이상 이 서비스로 위도/경도 좌표를 다중선 웨이포인트로 변환할 필요가 없습니다. 일부 Distance Matrix API 사용자는 위도/경도 지점을 다중선 경유지로 변환하여 요청 한도 문제를 해결했습니다.
형식이 지정된 주소 (역 지오코딩)
Routes API가 응답에 형식이 지정된 주소를 제공하지 않았습니다. 형식이 지정된 주소를 가져오려면 이 사용 사례에 맞게 빌드되고 더 높은 품질의 결과를 제공하는 Geocoding API를 사용하세요.
사용 가능한 이동 수단
Directions API와 마찬가지로 Routes API는 경로 요청에서 이동 수단을 지정하지 않으면 DRIVE를 기본 모드로 사용합니다. 그러나 요청에서 경로의 이동 수단을 지정하면 Routes API는 요청의 대체 옵션으로 사용 가능한 이동 수단 배열을 반환하지 않습니다. 사용 사례에서 이 기능을 사용하는 경우 Google에서 후속 조치를 취할 수 있도록 기능 사용 방법을 설명하는 문제를 신고해 주세요.
응답 형식으로 XML
Routes API는 XML을 응답 형식으로 제공하지 않습니다. 목적에 맞는 다양한 JSON-XML 변환기를 온라인에서 찾을 수 있습니다.