모든 준비를 마쳤습니다!

개발을 시작하려면 개발자 문서로 이동하세요.

Google Maps Directions API 활성화

개발을 시작하기 위해 Google Developers Console에서 우선적으로 해야 할 일을 몇 가지 소개하겠습니다.

  1. 프로젝트 생성 또는 선택
  2. Google Maps Directions API 활성화
  3. 적합한 키 생성
계속

시작하기

Google Maps Directions API는 위치 간의 찾아가는 길을 계산하는 서비스입니다. 대중교통, 자동차, 도보, 자전거 등 여러 이동 모드에 대한 찾아가는 길을 검색할 수 있습니다.

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

샘플 요청 및 응답

HTTP 인터페이스에서 Google Maps Directions API에 액세스하고 URL 문자열로 구성된 요청에서 텍스트 문자열 또는 경도/위도 좌표를 사용하여 API 키와 함께 위치를 확인합니다.

다음 예시는 디즈니랜드에서 할리우드 유니버설 스튜디오까지 자동차 길찾기를 JSON 형식으로 요청합니다.

https://maps.googleapis.com/maps/api/directions/json?origin=Disneyland&destination=Universal+Studios+Hollywood4&key=YOUR_API_KEY

체험해 보세요! 웹 브라우저에 URL을 입력하여 이 요청을 테스트할 수 있습니다. (‘YOUR_API_KEY’는 실제 API 키로 대체하세요.) 응답에서 자동차 길찾기를 반환합니다.

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

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

{
   "geocoded_waypoints" : [
      {
         "geocoder_status" : "OK",
         "place_id" : "ChIJRVY_etDX3IARGYLVpoq7f68",
         "types" : [
            "bus_station",
            "transit_station",
            "point_of_interest",
            "establishment"
         ]
      },
      {
         "geocoder_status" : "OK",
         "partial_match" : true,
         "place_id" : "ChIJp2Mn4E2-woARQS2FILlxUzk",
         "types" : [ "route" ]
      }
   ],
   "routes" : [
      {
         "bounds" : {
            "northeast" : {
               "lat" : 34.1330949,
               "lng" : -117.9143879
            },
            "southwest" : {
               "lat" : 33.8068768,
               "lng" : -118.3527671
            }
         },
         "copyrights" : "Map data ©2016 Google",
         "legs" : [
            {
               "distance" : {
                  "text" : "35.9 mi",
                  "value" : 57824
               },
               "duration" : {
                  "text" : "51 mins",
                  "value" : 3062
               },
               "end_address" : "Universal Studios Blvd, Los Angeles, CA 90068, USA",
               "end_location" : {
                  "lat" : 34.1330949,
                  "lng" : -118.3524442
               },
               "start_address" : "Disneyland (Harbor Blvd.), S Harbor Blvd, Anaheim, CA 92802, USA",
               "start_location" : {
                  "lat" : 33.8098177,
                  "lng" : -117.9154353
               },

  ... Additional results truncated in this example[] ...


         "overview_polyline" : {
            "points" : "knjmEnjunUbKCfEA?_@]@kMBeE@qIIoF@wH@eFFk@WOUI_@?u@j@k@`@EXLTZHh@Y`AgApAaCrCUd@cDpDuAtAoApA{YlZiBdBaIhGkFrDeCtBuFxFmIdJmOjPaChDeBlDiAdD}ApGcDxU}@hEmAxD}[tt@yNb\\yBdEqFnJqB~DeFxMgK~VsMr[uKzVoCxEsEtG}BzCkHhKWh@]t@{AxEcClLkCjLi@`CwBfHaEzJuBdEyEhIaBnCiF|K_Oz\\
            {MdZwAbDaKbUiB|CgCnDkDbEiE|FqBlDsLdXqQra@kX|m@aF|KcHtLm@pAaE~JcTxh@w\\`v@gQv`@}F`MqK`PeGzIyGfJiG~GeLhLgIpIcE~FsDrHcFfLqDzH{CxEwAbBgC|B}F|DiQzKsbBdeA{k@~\\oc@bWoKjGaEzCoEzEwDxFsUh^wJfOySx[uBnCgCbCoFlDmDvAiCr@eRzDuNxC_EvAiFpCaC|AqGpEwHzFoQnQoTrTqBlCyDnGmCfEmDpDyGzGsIzHuZzYwBpBsC`CqBlAsBbAqCxAoBrAqDdDcNfMgHbHiPtReBtCkD|GqAhBwBzBsG~FoAhAaCbDeBvD_BlEyM``@uBvKiA~DmAlCkA|B}@lBcChHoJnXcB`GoAnIS~CIjFDd]A|QMlD{@jH[vAk@`CoGxRgPzf@aBbHoB~HeMx^eDtJ}BnG{DhJU`@mBzCoCjDaAx@mAnAgCnBmAp@uAj@{Cr@wBPkB@kBSsEW{GV}BEeCWyAWwHs@qH?
            cIHkDXuDn@mCt@mE`BsH|CyAp@}AdAaAtAy@lBg@pCa@jE]fEcBhRq@pJKlCk@hLFrB@lD_@xCeA`DoBxDaHvM_FzImDzFeCpDeC|CkExDiJrHcBtAkDpDwObVuCpFeCdHoIl\\uBjIuClJsEvMyDbMqAhEoDlJ{C|J}FlZuBfLyDlXwB~QkArG_AnDiAxC{G|OgEdLaE`LkBbEwG~KgHnLoEjGgDxCaC`BuJdFkFtCgCnBuClD_HdMqEzHcBpB_C|BuEzCmPlIuE|B_EtDeBhCgAdCw@rCi@|DSfECrCAdCS~Di@jDYhA_AlC{AxCcL`U{GvM_DjFkBzBsB`BqDhBaEfAsTvEmEr@iCr@qDrAiFnCcEzCaE~D_@JmFdGQDwBvCeErEoD|BcFjC}DbEuD~D`@Zr@h@?d@Wr@}@vAgCbEaHfMqA`Cy@dAg@bAO`@gCi@w@W"
         },
         "summary" : "I-5 N and US-101 N",
         "warnings" : [],
         "waypoint_order" : []
      }
   ],
   "status" : "OK"
}

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

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

인증, 할당량 및 정책

API 활성화 및 API 키 가져오기

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

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

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

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

할당량

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

정책

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

자세히 알아보기

Directions API을 사용하면 다양한 이동 모드를 통해 길찾기 요청, 경유지를 사용하여 추가 위치를 통과하는 경로 계산, 이동 시간 예상 등을 수행할 수 있습니다. 더 많은 예시와 자세한 정보는 Directions API 개발자 가이드를 참조하세요.

다음에 대한 의견 보내기...

Google Maps Directions API
Google Maps Directions API
도움이 필요하시나요? 지원 페이지를 방문하세요.