지도상에 특정 지점을 표기하기 위해서는 위경도 좌표가 필요하다. 이를 위해서는 한글 또는 영문 주소를 위경도 좌표로 변환해야 하는데 이를 위해서 Google Map 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) 변환