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 to C
  • B~D

다음 예는 워싱턴 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 Client, Python Client, Go Client, Node.js Client는 커뮤니티 지원 클라이언트 라이브러리로, Apache 2.0 License에 따라 오픈소스로 제공됩니다. GitHub에서 다운로드하세요. GitHub에서 설치 안내와 샘플 코드도 확인할 수 있습니다.

다음 단계