Distance Matrix API

매트릭스 API는 단일 요청에서 출발지와 목적지의 모든 조합 간 이동 시간과 거리를 계산합니다. 일반적인 사용 사례로는 작업지에 가장 가까운 운전기사 또는 기술자 찾기, 차량 경로 문제 해결, 고객에게 배송 시간 창 추정, 시설 계획을 위한 서비스 지역 커버리지 계산 등이 있습니다.

길 안내 API는 두 지점 사이의 단일 상세 경로(회전 지시 및 형상 포함)를 반환합니다. 매트릭스 API는 경로 형상 없이 여러 출발지-목적지 쌍의 거리 및 소요 시간 표를 반환합니다. 많은 위치를 효율적으로 비교해야 한다면, 매트릭스 API가 개별 길 안내 호출보다 더 빠르고 비용 효율적입니다.

API는 단일 요청에서 최대 100개 출발지 대 100개 목적지의 매트릭스를 지원하여 호출당 최대 10,000개의 출발지-목적지 쌍을 처리합니다. 매트릭스는 정사각형일 필요가 없습니다. 가장 가까운 위치 조회에는 1개 출발지 대 100개 목적지를 보내거나, 전체 차량대 대 고객 할당에는 50 대 50을 보낼 수 있습니다.

매트릭스 API는 자동차, 도보, 자전거, 대중교통을 지원합니다. 이동 모드는 요청별로 설정됩니다. 단일 요청의 모든 쌍은 동일한 모드를 사용합니다. 혼합 모드 결과가 필요하면 각 모드에 대해 별도 요청을 보내고 애플리케이션에서 응답을 병합하세요.

기본적으로 매트릭스 API는 일반적인 도로 상황을 대표하는 자유 흐름 도로 속도를 사용합니다. 실시간 교통 조정 소요 시간은 해당 요금제에서 이용 가능합니다. departure_time 파라미터를 미래 타임스탬프로 설정하면 과거 교통 패턴에 기반한 시간대별 이동 시간 추정값을 받을 수 있습니다.

단일 조회 위치를 출발지로, 후보 위치 목록을 목적지로 보내세요. API는 한 번의 호출로 조회 지점에서 모든 후보 위치까지의 이동 시간과 거리를 반환합니다. 소요 시간으로 응답을 정렬하면 가장 가까운 옵션을 찾을 수 있습니다. 이 방법은 각 후보에 대해 길 안내 API를 루프에서 호출하는 것보다 훨씬 효율적입니다.