Mobile/Android(Kotlin)

[Android/Kotlin] Google Map API(구글 지도) 사용하기

개발왕 금골드 2020. 9. 1. 00:52
반응형

안녕하세요 골드입니다.

 Google Map API를 사용하는 방법에 대해서 글을 작성하도록 하겠습니다. 구글 지도는 많은 업데이트를 통해서 날이 갈수록 발전하고 있지만, 한국에서는 업데이트가 되고 있지 않다는 점 참고해주시기 바랍니다. 안드로이드에 지도 api를 추가하는 방법은 매우 간단합니다.

 

1. Google Maps Activity 생성하기

 안드로이드 스튜디오는 구글 지도를 굉장히 쉽게 사용할 수 있습니다. 왜냐하면 프로젝트를 새로 만들 때 처음부터 Google Maps Activity를 제공해주기 때문입니다. 

 Google Maps Activity로 새로운 프로젝트를 생성합니다. 

 

Google Play services installed

구글 지도 api를 사용하기 위해서는 Google Play services가 설치되어 있어야 합니다. 안드로이드 스튜디오 상단에 메뉴에서 Tools -> SDK Manager -> Android SDK를 클릭한 후 SDK Tools tab에서 Google Play services를 찾아 설치합니다. 구글 플레이 서비스를 사용하려면 API 키가 필요합니다. 키를 얻기 위해 google_maps_api.xml 파일로 이동합니다.  google_maps_api.xml은 Google Maps Activity로 프로젝트를 생성했을 경우 자동 생성됩니다. google_maps_api.xml은 app -> res -> values 디렉터리에 위치합니다. 

  • Google Play Services SDK Tool install

  • google_maps_api.xml에 API_KEY 입력

https:// 로 시작하는 url을 Ctrl 키를 누른 상태에서 마우스 클릭하면 해당 주소로 이동합니다.

<resources> 태그 안에 https:// 로 시작하는 url을 복사해 웹 브라우저의 주소창에 붙여넣기한 후 이동합니다. 이 주소는 Google Cloud Platform 콘솔 페이지 주소입니다. 해당 페이지에서 API를 사용하겠다고 알림과 동시에 키를 생성해야 합니다. Google Cloud Platform을 사용하기 위해 Google 아이디로 로그인합니다. (아이디가 없다면 생성해야 합니다. Google 아이디는 굉장히 유용하기 때문에 생성하는 게 좋습니다.)

  • Google Cloud Platform 웹페이지로 이동

console.cloud.google.com/home/dashboard?project=concrete-racer-288108&hl=ko&ref=https:%2F%2Fwww.google.com%2F

 

Google Cloud Platform

하나의 계정으로 모든 Google 서비스를 Google Cloud Platform을 사용하려면 로그인하세요.

accounts.google.com

2. Google Cloud Platform에서 API 키 생성하기

 

로그인 합니다. 로그인이 완료되면 아래에 이미지와 같이 Maps SDK for Android용 애플리케이션 등록 창이 나타납니다. 

 

아래에 서비스 약관에 체크하고 여러분의 상황에 맞게 설정을 진행한 다음 "계속" 버튼을 눌러서 어플리케이션 등록을 진행합니다. 

 

설정 창에서 "계속"을 누른 후 잠시 기다리면 프로젝트가 자동 생성되고 API 설정화면이 나타납니다. API를 호출하기 위해 "API 키 만들기" 버튼을 클릭합니다.

 

정상적으로 진행되었다면 API 키가 생성된 모습을 콘솔 창에서 확인할 수 있습니다. 오른쪽에 "키"가 있습니다. 여러분이 생성한 API 키를 복사합니다. 옆에 사각형 두개가 겹쳐진 아이콘이 복사 버튼입니다.

 

다시 여러분의 프로젝트로 돌아옵니다. 돌아와서 google_maps_api.xml 파일로 이동합니다. 이 파일에 아래쪽을 보시면 <string> 태그 사이에 YOUR_KEY_HERE라고 적혀있습니다. YOUR_KEY_HERE만 지우고 그 자리에 여러분이 위에서 복사했던 API 키를 붙여넣기 해줍니다.

  • 생성한 API_KEY를 google_maps_api.xml 파일에 복사 + 붙여 넣기

 

 앱을 빌드한 후 시작하면 시드니에 마커가 표시된 모습이 보이면서 구글 지도가 정상적으로 작동하는 모습을 볼 수 있습니다.


* 추가

만약 Google Map Activity를 생성하고 만든 것이 아닌 일반 프로젝트에 추가하고 싶다면 AndroidManifest.xml파일에 <meta-data> 태그 안에 api key를 작성하면 됩니다. 

그리고 play_service map과 location에 대한 의존성을 module build.gradle에 추가합니다.

마지막으로 Tools -> SDK Manager에서 Google Play Services가 install 되었는지 확인합니다.

 


 

혹시 안된다면 여러분의 여러분의 안드로이드 버전이 Google Play를 지원하는지 확인해주세요.

 

 

여기까지 골드였습니다.

감사합니다.

 

참고자료 : developers.google.com/maps/documentation/android-sdk/start

 

Get Started  |  Maps SDK for Android  |  Google Developers

Start a new Google Maps project for your Android app today. Here's how to find everything you'll need from installing the sdk to building and running your app.

developers.google.com

 

반응형