Distance Matrix API 개요

Distance Matrix API는 HTTPS 요청을 수락하는 서비스입니다. 지정된 운송 모드의 출발지와 목적지가 포함됩니다. 각 결합한 경우 이동 거리와 소요 시간을 반환합니다.

Distance Matrix API를 사용하는 이유

Distance Matrix API를 사용하여 가장 효율적인 여러 출발지와 목적지 사이의 이동 경로 대상 작업 현장으로 보낼 작업자 또는 창고에서 보낼 창고를 예로 들 수 있습니다. 패키지입니다

<ph type="x-smartling-placeholder">

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

Distance Matrix API를 사용하여 이동 거리와 시간을 제공할 수 있습니다. 출발지와 목적지 행렬입니다. 다음과 같은 몇 가지 옵션을 지정할 수 있습니다. 자동차, 자전거, 대중교통 또는 도보와 같은 이동 수단에 따라 대중교통 모드(예: 버스, 지하철, 기차, 전차, 철도)

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

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

지도와 API 응답에 출발지와 목적지가 표시된 지도

Distance Matrix API의 작동 방식

Distance Matrix API는 원하는 수의 출발지 (출발지)와 목적지를 사용하고 각 출발지 사이의 거리와 이동 시간을 반환합니다. 출발지 및 요청된 모든 목적지가 다음 단계로 진행합니다.

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

  • 가나다역순
  • 가나다순
  • B에서 C로
  • B부터 D까지

다음 예는 2개의 출처에 대한 요청을 보여줍니다. 워싱턴 DC 및 보스턴, 뉴욕주 뉴욕시에 단일 목적지가 있음 JSON 형식:

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 더 복잡한 요청 작성 여러 출발지와 목적지를 제공하는 요청을 시도해 보세요. 알아보기 계산을 제한하기 위한 선택적 매개변수(예: 지정된 출발 시간, 경로 제한 등이 있을 수 있습니다. 선택적 매개변수를 참고하세요. 자세한 내용은 거리 행렬 요청 및 응답 가이드를 참조하세요.
4 응답 기본사항 이해하기 데이터 응답을 살펴보고 앱에 대한 거리 행렬 데이터 사용을 준비하세요. 자세한 내용은 거리 행렬 응답 참조하세요.
5 거리 행렬 데이터를 앱에 통합하세요. 이 데이터를 사용하여 이동 거리와 시간을 계산할 수 있습니다.

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

이 API를 다음 언어로 호출 다음 클라이언트 라이브러리 중 하나를 통해 사용할 수 있습니다.

Google 지도용 Java 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트 서비스는 커뮤니티 지원 클라이언트 라이브러리로, Apache 2.0 라이선스. GitHub에서 다운로드하세요. GitHub에서 설치 안내와 샘플 코드도 찾을 수 있습니다.

다음 단계