Distance Matrix API 개요

유럽 경제 지역 (EEA) 개발자

소개

Distance Matrix API (기존)는 지정된 이동 수단의 출발지와 목적지를 포함하는 HTTPS 요청을 수락하는 서비스입니다. 출발지와 목적지의 각 조합에 대해 이동 거리와 이동 시간을 반환합니다.

Distance Matrix API를 사용하는 이유

Distance Matrix API를 사용하면 가능한 여러 출발지와 목적지 간의 가장 효율적인 이동 경로를 결정할 수 있습니다. 예를 들어 작업 현장에 보낼 작업자 또는 창고에서 보낼 택배를 결정할 수 있습니다.

Distance Matrix API로 수행할 수 있는 작업

Distance Matrix API를 사용하면 출발지와 목적지 행렬의 이동 거리와 시간을 제공할 수 있습니다. 운전, 자전거, 대중교통, 도보와 같은 이동 수단과 버스, 지하철, 기차, 트램, 철도와 같은 대중교통 수단을 비롯한 여러 옵션을 지정할 수 있습니다.

Distance Matrix API는 시작점과 끝점 간의 권장 경로를 기반으로 정보를 제공합니다. 다음과 같은 거리 데이터를 요청할 수 있습니다.

  • 선택한 이동 수단의 거리
  • 킬로미터 또는 마일 단위의 거리
  • 교통 체증 시 예상 이동 시간

지도에 출발지와 목적지가 표시되고 API 응답에 표시됨

Distance Matrix API의 작동 방식

Distance Matrix API는 여러 출발지 (시작점)와 목적지를 사용하고 요청의 첫 번째 출발지부터 시작하여 다음 단계로 진행하면서 각 출발지와 요청된 모든 목적지 간의 거리와 이동 시간을 반환합니다.

예를 들어 요청에서 A와 B를 출발지로, C와 D를 목적지로 지정하면 다음과 같은 순서로 거리와 이동 시간을 반환합니다.

  • A에서 C
  • A에서 D
  • B에서 C
  • B에서 D

다음 예는 JSON 형식으로 목적지가 뉴욕시, 뉴욕주인 두 출발지(워싱턴 DC 및 보스턴)에 대한 요청을 보여줍니다.

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

리소스

다음 표에는 Distance Matrix API를 통해 사용할 수 있는 리소스와 반환되는 데이터가 요약되어 있습니다.

데이터 리소스 반환된 데이터 반환 형식
거리 행렬

장소 ID, 주소 또는 위도/경도 좌표 형식으로 출발지와 목적지를 제공합니다.

  • 각 출발지와 각 목적지 간의 거리 및 이동 시간
  • 운전 모드와 출발 시간을 지정한 경우 교통 체증 시 이동 시간
  • JSON
  • XML

Distance Matrix API를 사용하는 방법

1 설정하기 Google Cloud 프로젝트 설정하기로 시작하고 이어지는 설정 안내를 완료합니다.
2 거리 행렬 요청해 보기 API 키가 있으면 브라우저에서 직접 Distance Matrix API 테스트를 시작할 수 있습니다. 예는 요청 샘플 _시작하기_ 가이드의 예제를 참고하세요.
3 더 복잡한 요청 작성 여러 출발지와 목적지를 제공하는 요청을 시도해 보세요. 계산(예: 지정된 출발 시간 또는 경로 제한)을 제한하는 선택적 매개변수에 대해 알아봅니다. Distance Matrix 요청 및 응답 가이드의 선택적 매개변수를 참고하세요.
4 응답 기본사항 이해하기 앱에 거리 행렬 데이터를 사용할 준비를 하려면 데이터 응답을 살펴보세요. 자세한 내용은 거리 행렬 응답 을 참고하세요.
5 거리 행렬 데이터를 자체 앱에 통합하기 이 데이터를 사용하여 이동 거리와 시간을 계산할 수 있습니다.

사용 가능한 클라이언트 라이브러리

다음 클라이언트 라이브러리 중 하나를 통해 원하는 언어로 이 API를 호출합니다.

Google 지도 서비스용 Java Client, Python Client, Go Client, Node.js Client는 커뮤니티 지원 클라이언트 라이브러리로, Apache 2.0 License에 따라 오픈 소스로 제공됩니다. GitHub에서 다운로드할 수 있으며, GitHub에서는 설치 안내와 샘플 코드도 찾을 수 있습니다.

다음 단계