Directions API 개요

Directions API는 HTTP 요청을 수락하고 위치 간의 JSON 또는 XML 형식의 경로를 반환하는 서비스입니다.

Directions API를 사용하는 이유

Directions API를 사용하면 대중교통, 운전, 도보, 자전거 등 여러 이동 수단에 대한 경로를 확인할 수 있습니다.

Directions API로 무엇을 할 수 있나요?

Directions API를 사용하면 다음 세부정보를 포함하여 위치 간의 경로를 계산할 수 있습니다.

  • 대중교통, 운전, 도보 또는 자전거 등 여러 이동 수단의 경로
  • 일련의 경유지를 사용하여 여러 경로를 반환합니다.
  • 텍스트 문자열 (예: '시카고, 일리노이' 또는 '다윈, 노던 티에리, 오스트레일리아'), 장소 ID 또는 위도/경도 좌표 등 다양한 방법으로 출발지, 목적지, 경유지를 지정합니다.

Directions API 작동 방식

Directions API는 경로를 계산할 때 가장 효율적인 경로를 반환합니다. 제품은 가장 효율적인 경로를 결정할 때 다음과 같은 이동 요소를 고려합니다.

  • 이동 시간 (기본)
  • 거리
  • 회전 수

다음 요청 예시는 온타리오 토론토에서 퀘벡 몬트리올까지의 자동차 길찾기를 JSON 형식으로 반환합니다.

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

리소스

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

데이터 리소스 반환된 데이터 반환 형식
경로

출발지와 도착지를 장소 ID, 주소 또는 위도/경도 좌표 형식으로 제공합니다. 자세한 내용은 필수 매개변수를 참고하세요.

경로, 구간, 단계로 나뉜 자세한 경로 안내 자세한 내용은 경로 응답을 참고하세요.
  • JSON
  • XML

Directions API 사용 방법

1 설정하기 Google Cloud 프로젝트 설정하기부터 시작하여 다음의 설정 안내를 완료합니다.
2 데모 사용해 보기 API 키와 클라우드 프로젝트가 있으면 무료로 경로 데모를 사용해 볼 수 있습니다. Directions API 데모를 참고하세요.
3 요청 빌드하기 요청 예시를 보고 이동 수단, 중간 지점, 경로 제한과 같이 제공할 수 있는 옵션에 대해 알아보세요. 경로 예시를 참고하세요.
4 응답 기본사항 이해하기 데이터 응답을 살펴보고 앱에서 경로 데이터를 사용할 준비를 합니다. 자세한 내용은 경로 응답을 참고하세요.
5 방향 데이터를 자체 앱에 통합하세요. 이 데이터를 사용하여 이동 거리와 시간을 계산할 수 있습니다.

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

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

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

다음 단계