Distance Matrix API 빠른 참조

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 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 API computeRouteMatrix(X-Goog-FieldMask 헤더 포함)로 이전합니다. 단기적인 조치로 양식을 통해서만 기존 API를 활성화합니다. /maps/legacy#LegacyApiNotActivatedMapError를 참고하세요.