GeoLocation 관련

• 개요
• geolocation/v2/geoLocation
  • 요청
  • 응답

---

geoLocation

---

이 문서는 로컬(Local) API 구현 방법을 소개합니다.

---

개요

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

공통 설정

메서드	URL	인증 방식
GET	https://geolocation.apigw.ntruss.com/geolocation/v2	Sub Account Access Key / API Gateway Signature

요청헤더

헤더명	설명
x-ncp-apigw-timestamp	1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond) 로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 x-ncp-apigw-timestamp:{Timestamp}
x-ncp-iam-access-key	네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값 x-ncp-iam-access-key:${Sub Account Access Key}
x-ncp-apigw-signature-v2	Access Key ID 값과 Secret Key로 암호화한 서명 x-ncp-apigw-signature-v2:${API Gateway Signature}

---

geolocation/v2/geoLocation

기본정보

메서드	URL	인증 방식
GET	https://geolocation.apigw.ntruss.com/geolocation/v2/geoLocation	Sub Account Access Key / API Gateway Signature

요청

curl

curl -v -X GET "https://geolocation.apigw.ntruss.com/geolocation/v2/geoLocation" \
  -H "x-ncp-apigw-timestamp: ${Timestamp}" \
  -H "x-ncp-iam-access-key: ${Sub Account Access Key}" \
  -H "x-ncp-apigw-signature-v2: ${API Gateway Signature}" \
  

응답

curl

---