GeoLocation 사용 가이드

GeoLocation 서비스소개

네이버 클라우드 플랫폼 GeoLocation 서비스의 개념과 기본 구조를 설명합니다.

GeoLocation이란

GeoLocation은 사용자 IP 기반 위치 정보를 제공하는 국내 유일의 서비스입니다. 이 서비스를 이용하여 사용자의 위치 및 지역 기반 콘텐츠 개인화, 광고 타겟팅, 트래픽 분석, DRM 관리, 어뷰징/ Fraud 탐지 등을 할 수 있습니다. GeoLocation은 네이버 클라우드 플랫폼에서 제공하는 API 서비스로, 아래 그림처럼 고객 서버에서 질의한 IP 주소에 대하여 지역 정보 DB(GeoLocation DB)를 검색하여 해당 지역의 정보를 고객 서버로 전달합니다. 이때 제공되는 정보에는 국가, 시/군/구, 동, 인근 지역의 좌표, 통신사 정보 등입니다.
IP 주소별 위치 정보는 매일 수시로 갱신되며 항상 최신 정보를 반영할 수 있도록 유지되고 있습니다.

서비스 특징

검증된 서비스

GeoLocation은 네이버에서 오랜 기간 사용되고 검증된 서비스입니다.
네이버의 수십 개 서비스가 GeoLocation을 사용하고 있으며 대표적으로 검색 광고, 날씨, 지도, 동영상 등의 서비스가 있습니다.

이용 사례1 네이버 검색광고

검색 결과가 검색자의 현재 위치와 관련되는 경우에 지역 관련 광고를 노출

이용 사례2 네이버 날씨

사용자의 현재 위치에 대한 날씨를 관심 지역으로 제안

이용 사례3 네이버 지도

네이버 지도의 초기 화면이 사용자의 현재 위치로 설정됨

이용 사례4 네이버 동영상

동영상과 같은 미디어 콘텐츠들은 특정 국가에 대해 제공이 금지된 경우가 있어서 사용자 위치에 따라 제공 여부 판단

서비스 활용

아래 그림은 Geolocation을 활용하여 사용자에게 맞춤 서비스를 제공하는 구조의 예시입니다.
1. 고객의 웹서버는 사용자로부터 받은 웹 페이지 요청으로부터 사용자 IP 주소를 획득합니다.
2. GeoLocation API를 호출하여 사용자의 지역정보를 얻습니다.
3. 고객은 사용자 지역별로 제공할 콘텐츠를 미리 DB화하고 있어서, GeoLocation API의 결과를 이용해 적절한 콘텐츠를 선택합니다.
4. 사용자에게 맞춤 콘텐츠를 제공합니다.

사용자 인증

GeoLocation은 API 서비스이며 API 호출 건수당 과금이 되기 때문에, 고객이 아닌 타인에 의해 서비스가 사용되어 금전적 손실을 입지 않도록 IAM 인증을 통해 인증된 고객만이 사용 가능합니다. 자세한 설명은 API Gateway의 예제코드 API Gateway 예제코드를 참조하시기 바랍니다.

사용상 유의점

GeoLocation은 IP별 위치 정보의 최신성을 유지하기 위해 많은 Data 분석을 하고 있으나, 아래의 이유들로 인해 항상 정확한 정보를 갖는 것은 아닙니다.

• 통신사들은 한정된 자원인 IP 주소를 효율적으로 사용하기 위해 수시로 회수 및 재할당합니다.
• 통신사가 IP 주소를 할당할 때는 행정구역 구획에 따르지 않고 통신사의 국사를 기준으로 하기 때문에 간혹 유사 IP 주소가 동 경계 혹은 시 경계에 걸쳐 있을 수도 있습니다.
• IP의 위치 정보가 변경된 이후에 GeoLocation이 분석에 필요한 정보를 수집하기까지는 다소 시간이 소요됩니다.
• 3G, LTE와 같은 모바일 네트워크 환경에서는 IP 재할당이 인근 지역으로 되지 않고 전국단위로 이루어 집니다. GeoLocation이 해당 정보를 수집 및 분석하는 사이에도 수 차례 재할당이 발생하기 때문에 정확도를 보장할 수 없어서, GeoLocation은 모바일 네트워크의 IP 주소에 대해서는 위치 정보를 제공하지 않습니다.
• NAT, VPN, Proxy 등으로 사용되는 IP는 모바일 네트워크와 유사하게 매우 넓은 지역에서 사용되는 경향이 있습니다. 1개의 IP를 여러 사람이 공유해서 사용하기 때문인데, GeoLocation의 정확도가 낮아질 수 있습니다.
  이러한 환경을 고려하여 GeoLocation을 사용하시기 바랍니다.

사용 한도 설정

고객 서비스로의 과다한 요청 유입 혹은 고객 응용 프로그램의 오류 등으로 인하여 의도치 않게 GeoLocation API를 많이 호출하는 것을 막을 수 있도록 사용 한도(Quota)를 정할 수 있습니다. 월 API호출 수에 대한 사용 한도를 설정하면, 실제 API 호출 수가 사용 한도에 다다를 경우 API 호출이 제한되며 SMS/Mail 알림을 받을 수 있습니다. 그리고, 필요에 따라 언제든지 사용 한도를 재설정할 수 있습니다. 사용 한도 설정 기능은 고객을 위한 편의 기능이며, 수 분 가량 사용 한도를 초과하여 호출할 수 있는 점 유의하시기 바랍니다.

과금

성공적인 API 호출 건수에 따라 과금되며, 인증 오류, 네이버 클라우드 플랫폼 내부 오류나 IP에 대한 위치를 찾지 못하는 등 정상적이지 않은 호출에 대해서는 과금되지 않습니다. 월 단위 전체 정상 호출 건수에 대하여 과금되며, 시간대별 호출 건수는 쿼리 현황 메뉴(Usage Statistics)에서 조회할 수 있습니다. 호출 건수별 요금은 네이버 클라우드 플랫폼 포털 > 마이페이지 > 요금 계산기에서 조회 가능하며, 청구 금액은 네이버 클라우드 플랫폼 포털 > 마이페이지 > 이용현황에서 조회할 수 있습니다.

GeoLocation API 사용하기

GeoLocation API의 요청과 응답 형식을 설명합니다.

• API 참조서 > Application > Geolocation

GeoLocation 시작하기

GeoLocation 서비스를 처음 시작할 때 필요한 내용을 설명합니다.

GeoLocation 이용 신청

GeoLocation을 처음 시작하여 API를 사용하는 과정은 아래와 같습니다.

① 네이버 클라우드 플랫폼 포털에 접속하여 로그인합니다.

② 로그인 후 오른쪽 상단의 콘솔 버튼을 클릭하여 네이버 클라우드 플랫폼 콘솔로 접속합니다.

③ 좌측 메뉴에서 Services 를 클릭합니다.

④ GeoLocation 메뉴를 클릭합니다.

⑤ GeoLocation 메뉴에서 Subscription 버튼을 클릭하면 이용 신청이 나타납니다.
이미 이용신청이 된 상태에서는 이용해지 화면이 보이고 이용신청 버튼은 비활성화됩니다.

⑥ 이용 신청 버튼을 클릭하면 서비스 이용약관 팝업이 뜹니다. 이용약관을 검토한 후에 약관 동의와 월별 사용 한도 설정을 합니다. 사용 한도 설정을 하지 않으면 무제한 사용으로 설정됩니다. 월별 최대 호출 건수를 숫자로 입력하여 설정 가능하며, 사용 한도 설정은 이용 신청 후에도 언제든지 변경 가능합니다. 설정 가능한 최솟값은 0, 최댓값은 9007199254740991입니다.

⑦ 이용 신청이 완료된 후에 사용 한도 설정을 하려면 좌측 메뉴의 GeoLocation 메뉴 하단에 있는 Quota Setting 메뉴를 클릭합니다. 이용 신청 화면에서와 유사한 방법으로 월별 사용한도를 무제한으로 설정할지 혹은 제한할지를 결정합니다. 사용한도를 제한하는 경우에 월별 최대 호출 건수를 입력한 후에 설정을 저장하면 반영됩니다. 반영되는 데에는 최대 1~2분 가량 소요될 수 있습니다. 만약 사용 한도를 수정하는 경우에 설정값이 현재의 호출 건수보다 작은 경우에는 즉시 사용을 제한하게 됩니다.

⑧ Usage Statistics 메뉴에서 최근 이용 내역을 조회할 수 있으며 파일 다운로드 버튼을 클릭해서 이용 내역을 파일로 받을 수 있습니다.