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 |
|
더 빠른 요청 응답
컴퓨팅 경로 매트릭스 기능은 다음과 같은 지연 시간 개선사항을 제공합니다.
- 전체 매트릭스가 계산되기 전에 응답의 스트리밍 요소를 수신합니다.
- 필드 마스크를 사용하여 응답 세부정보를 맞춤설정하여 필요한 데이터만 요청합니다. 이는 비용 절감에 도움이 되는 권장사항입니다.
- 교통정보에 대한 향상된 경로 계산: 데이터 품질과 응답 시간 간의 균형을 맞출 수 있습니다.
라우팅 개선사항
컴퓨팅 경로 기능은 다음과 같이 향상된 라우팅 기능을 제공합니다.
- 거리 및 도착예정시간 외에 통행료 정보가 제공됩니다.
- 이륜차 경로.
- 안전을 위해 경유지 자격요건을 확인하세요.
- 경유지의 이동 방향과 도로 측을 설정하여 도착예정시간 정확도가 향상되었습니다.
필요한 데이터만 요청
이제 반환할 필드를 지정하여 처리 시간과 청구 비용을 줄일 수 있습니다.
| 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에서 새로운 모드를 추가했습니다. ETA 품질은 약간 낮지만
|
| 포괄적인 실시간 교통정보의 고품질 데이터 적용 | 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 |
두 가지 서비스, 즉 Directions API 및 Distance Matrix API를 API 콘솔에서 별도의 서비스로 사용 설정하세요. |
HTTPS POST 요청 사용
| Routes API | 요청 본문이나 헤더의 매개변수를 HTTP POST 요청의 일부로 전달합니다. 예를 참고하세요. - 경로 계산 - 경로 행렬 계산 |
| Directions API Distance Matrix API |
HTTP GET 요청을 사용하여 URL 매개변수를 전달합니다. |
도착예정시간 응답 차이
Routes API는 도착예정시간을 반환하고 아래 표에 나온 것처럼 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 변환기를 찾을 수 있습니다.