이 데모에서는 Directions API (기존)를 사용하여 한 위치에서 다른 위치로 가는 운전 경로를 가져오는 방법을 보여줍니다. 이 데모는 무료로 실행할 수 있습니다. 이 데모를 실행하는 것만으로는 월간 할당량이 초과되지 않습니다.
시작하기 전에
Directions API (기존)를 사용하려면 다음 필수 설정 단계를 완료하세요.
1단계: 프로젝트 설정
콘솔
-
Google Cloud 콘솔의 프로젝트 선택기 페이지에서 프로젝트 만들기를 클릭하여 새 Cloud 프로젝트를 만듭니다.
-
Cloud 프로젝트에 결제가 사용 설정되어 있어야 하므로 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.
Google Cloud에서는 0.00달러의 무료 체험판을 제공합니다. 무료 체험판은 90일 후 또는 계정에서 300달러에 해당하는 누적 비용이 발생한 시점 중 더 빠른 시점에 만료됩니다. 취소는 언제든지 가능합니다. 자세한 내용은 결제 계정 크레딧 및 결제를 참고하세요.
Cloud SDK
gcloud projects create "PROJECT"
Google Cloud SDK, Cloud SDK 설치 및 다음 명령어에 대해 자세히 알아보세요.
2단계: API 또는 SDK 사용 설정
Google Maps Platform을 사용하려면 프로젝트에 사용할 API 또는 SDK를 사용 설정해야 합니다.
콘솔
Cloud SDK
gcloud services enable \ --project "PROJECT" \ "directions-backend.googleapis.com"
Google Cloud SDK, Cloud SDK 설치 및 다음 명령어에 대해 자세히 알아보세요.
3단계: API 키 가져오기
이 단계에서는 API 키만 만듭니다. 프로덕션에서 API 키를 사용하는 경우 API 키를 제한하는 것이 좋습니다. 자세한 내용은 제품별 API 키 사용 페이지를 참고하세요.
API 키는 사용 및 결제 목적으로 프로젝트와 관련된 요청을 인증하는 고유 식별자입니다. 프로젝트에 연결된 API 키가 하나 이상 있어야 합니다. 새 키를 만들거나 기존 키에 API 또는 SDK를 추가하려면 다음 안내를 따르세요.
콘솔
-
Google Maps Platform > 키 및 사용자 인증 정보 페이지로 이동합니다.
- 메시지가 나타나면 프로젝트를 선택합니다.
-
다음 중 하나를 수행합니다.
-
새 키 만들기:
- 사용자 인증 정보 만들기 > API 키를 클릭합니다.
- API 키 만들기 패널에서 API 제한사항 선택 목록을 엽니다.
- 이 키에 필요하지 않은 API를 모두 지우고 Directions API가 선택된 상태로 유지되는지 확인합니다.
- 만들기를 클릭합니다. 패널에 새 API 키가 표시됩니다.
-
기존 키 사용:
- 키 이름을 클릭합니다.
- API 제한사항 선택 목록에서 Directions API를 선택합니다.
- 저장을 클릭합니다.
여기에서 API를 선택해도 사용 설정되지 않습니다. API 라이브러리 페이지에서 Directions API가 사용 설정되어 있는지 확인합니다.
-
- 나중에 키 문자열을 보려면 키 및 사용자 인증 정보 페이지로 이동하여 키의 키 표시를 클릭합니다.
콘솔이 이 단계와 다르게 표시되면 Google Cloud 문서의 API 키 만들기 및 API 제한사항 추가를 참고하세요.
Cloud SDK
다음 명령어에서 PROJECT_ID를 프로젝트 ID로 바꿉니다.
-
새 키 만들기: 다음 명령어를 실행하고 DISPLAY_NAME를 키 이름으로 바꿉니다.
gcloud services api-keys create \ --project="PROJECT_ID" \ --display-name="DISPLAY_NAME" \ --api-target=service=directions-backend.googleapis.com
Google Cloud SDK, Cloud SDK 설치 및 다음 명령어에 대해 자세히 알아보세요.
-
기존 키 사용: 다음 명령어를 실행하고 KEY_ID를 키 ID로 바꿉니다.
--append플래그는 키가 이미 허용하는 API를 유지합니다. 이 플래그가 없으면 명령어가 이를 대체합니다.gcloud services api-keys update KEY_ID \ --project="PROJECT_ID" \ --append \ --api-target=service=directions-backend.googleapis.com
Google Cloud SDK, Cloud SDK 설치 및 다음 명령어에 대해 자세히 알아보세요.
키 ID는 키 문자열 또는 표시 이름이 아닙니다. 이를 찾으려면
gcloud services api-keys list --project="PROJECT_ID"를 실행합니다. ID는name필드의 마지막 부분입니다.projects/PROJECT_NUMBER/locations/global/keys/KEY_ID
키 문자열을 보려면 gcloud services api-keys get-key-string KEY_ID
--project="PROJECT_ID"를 실행합니다.
길찾기
디즈니랜드에서 유니버설 스튜디오 할리우드까지의 운전 경로를 JSON 형식으로 받으려면 웹브라우저에 URL을 입력하고 YOUR_API_KEY를 API 키로 바꿉니다.
https://maps.googleapis.com/maps/api/directions/json?origin=Disneyland&destination=Universal+Studios+Hollywood&key=YOUR_API_KEY다음과 같은 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 shortened 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" }
수고하셨습니다. Directions API (기존)를 설정하고 호출하여 경로를 수신했습니다.
삭제
Google Cloud 프로젝트를 삭제하여 프로젝트 내에 사용된 모든 리소스에 대한 비용 청구를 중지할 수 있습니다.
- Google Cloud 콘솔에서 리소스 관리 페이지로 이동합니다.
- 삭제하려는 프로젝트가 조직에 연결되어 있으면 페이지 상단에서 조직 목록을 선택하고 펼칩니다.
- 프로젝트 목록에서 삭제할 프로젝트를 선택하고 삭제를 클릭합니다.
- 대화상자에서 프로젝트 ID를 입력하고 종료를 클릭하여 프로젝트를 삭제합니다.
다음 단계
Google Cloud 프로젝트를 설정하여 Directions API (기존)로 개발을 시작하세요.
Directions API (기존) HTTP 요청을 빌드할 때 모든 매개변수 목록은 다음을 참고하세요.
인증, 요청 제한, 자동 재시도와 같은 일반적인 작업의 간단한 네이티브 구현을 제공하는 클라이언트 라이브러리로 코딩하는 방법을 알아보세요. Directions API (기존)는 Google 지도 서비스용 Java 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트에서 사용할 수 있습니다.