Distance Matrix API(기존)는 각 출발지-목적지 쌍 간의 추천 경로를 기반으로 출발지 및 목적지 행렬의 이동 거리와 시간을 반환하는 웹 서비스입니다. 이동 수단(운전, 도보, 자전거, 대중교통), 대중교통 모드, 단위, 교통 상황에 따른 소요 시간의 출발 시간을 설정할 수 있습니다. JSON 또는 XML을 반환합니다.
Distance Matrix API: 주요 사실
- 제품: Distance Matrix API
- 다른 이름: Distance Matrix API(기존), Distance Matrix(기존)
- 카테고리: 경로
- 플랫폼: 웹 서비스(REST)
- 실행 위치: 서버(백엔드 코드)
- 출시 단계: GA
- 수명 주기: 기존
- 대체: Routes API
- 개요: Distance Matrix API 개요
Distance Matrix API: 사용해야 하는 경우
다음과 같은 경우 Distance Matrix API를 사용하세요.
- Distance Matrix API(기존)가 이미 사용 설정되어 있고
/maps/api/distancematrix를 호출하는 기존 프로젝트를 유지합니다. - 서버에서 여러 출발지와 여러 목적지 간의 이동 거리와 시간이 필요합니다.
departure_time및 선택적traffic_model를 사용하여 운전 시 교통 상황을 반영한 소요 시간이 필요합니다.
다음과 같은 경우에는 Distance Matrix API를 사용하지 마세요.
- 새 Google Cloud 프로젝트를 시작합니다. 2026년 10월부터는 새 프로젝트에 Distance Matrix API(기존)를 사용 설정할 수 없습니다. 대신 Routes API를 사용하세요.
- 새로운 기능 또는 스트리밍 응답이 포함된 최대 625개 요소의 경로 매트릭스가 필요합니다(
computeRouteMatrix). 대신 Routes API를 사용하세요. - 거리 및 소요 시간 값뿐만 아니라 지점 간의 단계와 다중선이 포함된 전체 경로가 필요합니다. 대신 Routes API를 사용하세요.
Distance Matrix API: 설정
- 사용 설정할 서비스:
distance-matrix-backend.googleapis.com - 인증: API 키
- 시작하기: Distance Matrix API 설정
- 참조: Distance Matrix API 참조
- 가격 책정: Distance Matrix API 사용량 및 결제
- 정책: Distance Matrix API 정책
- 출시 노트: Distance Matrix API 출시 노트
Distance Matrix API: 일반적인 실수
- 문제: 각 서버 측 요청은 100개의 요소(출발지 × 목적지)와 25개의 출발지 또는 25개의 목적지로 제한됩니다. 더 큰 요청은
MAX_ELEMENTS_EXCEEDED또는MAX_DIMENSIONS_EXCEEDED를 반환합니다. 해결 방법: 행렬을 요소 100개 이하, 출발지 또는 목적지 25개 이하의 요청으로 분할합니다. /maps/documentation/distance-matrix/usage-and-billing#usage-limits를 참고하세요. - 문제:
departure_time를 지정하지 않으면 경로와 소요 시간이 평균 시간과 무관한 교통상황을 기반으로 하며duration_in_traffic가 반환되지 않습니다. 결과는 시간이 지남에 따라 달라질 수 있습니다. 해결 방법:departure_time를now또는mode=driving를 사용하여 미래 시간으로 설정하여 교통정보를 반영한 소요 시간을 가져옵니다. 교통정보 요청에는 비교적 높은 청구 요율이 적용됩니다. /maps/documentation/distance-matrix/distance-matrix를 참고하세요. - 문제:
units매개변수는 거리 필드의 텍스트만 변경합니다. 거리 값은 항상 미터 단위입니다. 수정:distance.value를 미터로 읽거나distance.text를 사용하여 표시합니다. /maps/documentation/distance-matrix/distance-matrix를 참고하세요. - 문제: Distance Matrix API(기존)가 사용 설정되지 않은 프로젝트에서 이 API를 호출하면
status에REQUEST_DENIED가 반환되고LegacyApiNotActivatedMapError에 연결되는error_message가 반환됩니다. AI 어시스턴트는 기본적으로 기존 API 코드를 생성하는 경우가 많습니다. 해결 방법: Routes APIcomputeRouteMatrix(X-Goog-FieldMask헤더 포함)로 이전합니다. 단기적인 조치로 양식을 통해서만 기존 API를 활성화합니다. /maps/legacy#LegacyApiNotActivatedMapError를 참고하세요.