Etc) GCP - 가입 및 지오코딩(geocoding) API 신청

개요

지도 서비스를 제공하는 플랫폼의 경우 한글 또는 영문 주소를 위경도 좌표로 변환하는 지오코딩(geocoding)을 API로 제공한다. 그 중에서 GCP(Google Cloud Platform)의 지오코딩 API를 다뤄보고자 하며 회원 가입부터 서비스 및 API키 신청 까지 알아본다. 그리고 본 포스팅에 있는 화면은 Google이 업데이트를 함에 따라 그 순서 또는 화면 구성이 일부 달라질 수 있으니 참고바란다.

회원 가입

GCP 메인 화면은 다음과 같다.

당연히 Google 계정이 있어야 하며 다음 이미지의 절차를 시작으로 이것저것 개인정보와 결제 정보를 입력하게 된다. 일단 무료 크레딧을 300$ 주기 때문에 처음에 이것저것 막 눌러도 별 걱정이 없으니 안심하고 사용하면 된다. 가끔 카페의 아이스아메리카노는 물처럼 마시면서 온라인에서 1$ 쓰는 것에 유난히 벌벌떠는 사람이 있는데 잘 보고 따라하고 실수만 안하면 돈 쓸일 없으니 안심하도록 하자.

신규 가입자는 다음 절차가 없을 수 있으나 GCP를 어느 정도 사용하다 보면 계정을 업그레이드 하라는 안내문구가 뜬다. 딱히 다른점을 모르겠으나 모든 기능을 사용할 수 있다니까 일단 눌러보자.

추가 정보기입 등 별다른 절차 없이 다음과 같은 메세지가 뜨면서 계정 업그레이드가 완료된다.

업그레이드 후의 GCP 대시보드 메인화면은 다음과 같다.

프로젝트 생성

GCP 서비스를 사용하려면 프로젝트 생성이 필요할 수 있다. 우리는 GCP의 지오코딩(geocoding) API 서비스를 사용할 예정이기에 반드시 프로젝트를 만들어야 한다. 프로젝트명은 고유해야 하며 다음 이미지에서 볼 수 있듯 원하는 이름을 지정할 수 있다. 하지만 다른 사람이 이전에 생성한 프로젝트명과 같은 이름을 기입한다면 자동으로 이름 뒤에 숫자를 부여한다.

이름을 지정하고 [만들기] 버튼을 누르면 다음과 같이 신규 프로젝트가 생성된 것을 확인할 수 있다.

API 신청

이제 해당 프로젝트를 이용하기 위한 API 사용 신청을 하도록 하자. 우선 화면 상단의 [+ API 및 서비스 사용 설정]버튼을 누르자.

만약 상기 버튼이 보이지 않는다면 다음과 같이 3선 버튼을 누른 후 [API 및 서비스] 버튼의 하위 버트인 [라이브러리] 버튼을 누르면 GCP의 각종 서비스를 검색할 수 있는 화면이 나온다.

GCP의 각종 서비스를 검색할 수 있는 화면이 나온다.

검색창에 “geo” 라고만 쳐도 검색 결과 최상단에서 지오코딩(geocoding) API를 확인할 수 있다. 눌러보자.

지오코딩 API 영역을 눌러 진입하면 다음과 같은 화면을 볼 수 있으며 [사용] 버튼을 누르면 바로 API를 사용할 수 있다.

지오코딩 API의 이용요금은 다음과 같으며 환율에 따라 조금씩 달라지지만 대략 1800번 호출에 만원 정도 요금이 발생한다. 그래도 매달 200$ 무료 크레딧을 주니 지오코딩 API만 이용하는 경우 매달 3만건 호출을 해도 과금이 될 일은 없으니 안심해도 된다.

지오코딩 API 사용 신청 후 다음과 같은 대쉬보드 화면으로 돌아온다.

API 키 발급

계정 생성, 프로젝트 생성, API 사용 신청 까지 마친 상태라면 이제 API를 이용하기 위한 키(key)를 발급받아야 한다. 대시보드 왼편의 [사용자 인증 정보] 메뉴를 누르게 되면 다음과 같은 화면을 볼 수 있다.

위 화면에서 [API 및 서비스의 사용자 인증 정보] 로 이동하라는 문구가 있는데 해당 메뉴로 이동하려면 저 링크를 눌러도 되고, 다음 이미지 처럼 왼쪽 메뉴 중 [API 및 서비스] 에서 [사용자 인증 정보] 메뉴 버튼을 눌러도 된다.

화면 상단의 [+ 사용자 인증 정보 만들기] 버튼을 눌러보자.

메뉴 최상단의 [API 키] 를 누른다.

다음과 같이 바로 발급이 되는 것을 확인할 수 있다.

※ 해당 키는 포스팅 직전에 삭제했으니 걱정하지 마시라.

발급 즉시 API 키를 복사하지 않더라도 다음과 같이 사용자 인증 정보 화면에서 기존에 발급한 API 키를 확인할 수 있고 언제든 확인할 수 있다.

주의 사항

여기서 생성한 API키는 외부에 노출하면 매우 좋지 않은 상황이 발생할 수 있다. 만약 노출이 되었다고 판단되면, API키를 즉시 변경 또는 삭제를 권장한다.

<R 지도 핸들링 시리즈>
R) ggplot2 - 세계지도
R) ggplot2 - 한국 행정경계지도
R) ggplot2 - 서울 통계자료 매핑
Etc) GCP - 가입 및 지오코딩(geocoding) API 신청
R) 전처리 - 지오코딩(Google Map)
R) 시각화 - Google 지도
R) 전처리 - 지점간 거리 계산
R) 전처리 - 지리 좌표계(CRS) 변환