시작하기

Google Maps Distance Matrix API는 출발 지점과 종료 지점 사이의 추천 경로에 따라 출발지와 목적지 매트릭스에 대한 이동 거리와 시간을 제공하는 서비스입니다.

이 서비스는 또한 클라이언트측 Google Maps JavaScript API의 일부로 제공되거나 서버측에서 Java Client, Python Client, Go Client 및 Node.js Client for Google Maps Services와 함께 사용됩니다.

샘플 요청 및 응답

HTTP 인터페이스에서 Google Maps Distance Matrix API에 액세스하고 URL 문자열로 구성된 요청에서 origins와 destinations를 사용하여 API 키와 함께 위치를 확인합니다.

다음 예시에서는 워싱턴 DC 워싱턴과 뉴욕 주 뉴욕시 사이의 거리 매트릭스 데이터를 JSON 형식으로 요청합니다.

https://maps.googleapis.com/maps/api/distancematrix/json?units=imperial&origins=Washington,DC&destinations=New+York+City,NY&key=YOUR_API_KEY

체험해 보세요! 웹 브라우저에 URL을 입력하여 이 요청을 테스트할 수 있습니다. (YOUR_API_KEY는 실제 API 키로 대체하세요.) 응답에는 지정된 출발지와 목적지 사이의 거리와 이동 시간이 포함됩니다.

개발자 가이드에서 요청 URL 빌드 및 이용 가능한 매개변수와 응답 이해에 관한 자세한 정보를 참조하세요.

다음은 JSON 형식의 샘플 응답입니다.

{
   "destination_addresses" : [ "New York, NY, USA" ],
   "origin_addresses" : [ "Washington, DC, USA" ],
   "rows" : [
      {
         "elements" : [
            {
               "distance" : {
                  "text" : "225 mi",
                  "value" : 361715
               },
               "duration" : {
                  "text" : "3 hours 49 mins",
                  "value" : 13725
               },
               "status" : "OK"
            }
         ]
      }
   ],
   "status" : "OK"
}

클라이언트 라이브러리로 코딩 시작하기

클라이언트 라이브러리를 사용하면 인증, 요청 차단, 자동 재시도와 같은 일반적인 작업을 간단하게 구현할 수 있으며, Google Maps Web Service API를 사용한 개발이 더욱 쉬워집니다. Google Maps Distance Matrix API는 Java Client, Python Client, Go Client 및 Node.js Client for Google Maps Services에서 이용할 수 있습니다.

인증, 할당량 및 정책

API 활성화 및 API 키 가져오기

Google Maps Distance Matrix API를 사용하려면 먼저 Google API Console에서 API를 활성화하고 적절한 인증 자격 증명을 획득해야 합니다. 각 요청에 API 키를 제공해야 합니다(또는 프리미엄 플랜일 경우 클라이언트 ID).

아래 버튼을 클릭하여 다음 절차를 수행합니다.

1. 프로젝트 생성 또는 선택
2. API 활성화
3. API 키 가져오기

키 가져오기

인증 자격 증명에 대해 자세히 알아보세요.

할당량

사용자 제한 페이지에서 Google Maps Distance Matrix API의 할당량 설정에 관한 자세한 정보를 검토합니다.

정책

Google Maps Distance Matrix API를 사용할 때는 API 정책을 준수해야 합니다.

자세히 알아보기

그 외에도 Distance Matrix API의 기능은 여러 가지가 있습니다. 예를 들어 다양한 이동 수단에 대한 거리 데이터 요청, 다양한 단위로 거리 데이터 요청(예: 킬로미터 또는 마일), 예상 교통 이동 시간 등이 있습니다. 더 많은 예시와 자세한 정보는 Distance Matrix API 개발자 가이드를 참조하세요.