포털 바로가기 네이버 클라우드 플랫폼 설명서

네이버 클라우드 플랫폼의 상품 사용 방법을 보다 상세하게 제공하고, 다양한 API의 활용을 돕기 위해 [설명서]와 [API 참조서]를 구분하여 제공하고 있습니다.

Geolocation API 참조서 바로가기 >>
Geolocation 설명서 바로가기 >>

GeoLocation API 개요

GeoLocation API의 요청과 응답 형식을 설명합니다. 네이버 클라우드 플랫폼에서 제공하는 응용 프로그램 인터페이스(API)를 네이버 클라우드 플랫폼 API라고 합니다. 네이버 클라우드 플랫폼 API는 RESTful 형태로 제공되며 HTTP GET 메서드 호출을 통해서 이루어집니다.

공통설정

• Geolocation API는 v1, v2 두가지 버전을 제공하고 있습니다.

• {GEOLOCATION_API_URL} (v1)

  https://ncloud.apigw.ntruss.com/geolocation/v1
  

• request header (v1)

• {GEOLOCATION_API_URL} (v2)

  https://geolocation.apigw.ntruss.com/geolocation/v2
  

• request header (v2)

• x-ncp-apigw-signature 생성 예제는 Ncloud APIs > 공통가이드 AUTHPARAMS 생성하기 예제를 참조하세요.

Fade Out API

• 기존 구 버젼 Geolocation API는 Oauth인증을 사용합니다. 2019년 6월 30일까지만 이용이 가능하며 v2를 사용하시길 바랍니다.

AUTHPARAMS

• 사용자 인증 관련 정보
• oauth_consumer_key={your_key}
• oauth_signature_method=HMAC-SHA1
• oauth_version=1.0
• oauth_timestamp=1494042435
• oauth_nonce=983853020394837722989312
• oauth_signature={obtain_signature}

API 요청 URL 사용 예는 다음과 같습니다.

https://api.ncloud.com/geolocation/?action=getLocation&ip=x.x.x.x&enc=utf8&ext=t&responseFormatType=xml&oauth_consumer_key={your_key}oauth_nonce=983853020394837722989312&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1494042435&oauth_version=1.0&oauth_signature={obtain_signature}

API 요청 예시 구성

API References

• GeoLocation
  • 위치정보 조회

GeoLocation

geoLocation

• API명

  위치정보 조회

• action

  geoLocation

• 요청 파라미터

  • ip
    • 필수
    • 지역 정보를 알고자 하는 사용자 IP.
  • enc
    • 인코딩 방식('utf8' (기본값) 또는 'euckr')
  • ext
    • 추가 정보 포함 여부 ('t' (포함) 또는 'f' (비포함, 기본값))
  • responseFormatType
    • 응답 포맷을 선택 ('xml' (기본값) 또는 'json')

• Example

  • 요청

    {GEOLOCATION_API_URL}/geoLocation
    ?ip=x.x.x.x
    &enc=utf8
    &ext=t
    &responseFormatType=xml
    

  • 응답

정상 출력 결과 (ext =f의 결과)

예1)

JSON 형식	XML 형식

예2)

JSON 형식	XML 형식

정상 출력 결과 (ext=t의 결과)

예1)

JSON 형식	XML 형식

예2)

JSON 형식	XML 형식

비정상 출력 결과

JSON 형식	XML 형식

출력 결과 설명

응답코드값

이 외의 코드값에 대해서는 네이버 클라우드 플랫폼 포털 > 설명서 > API를 참조하세요.

API 사용 예제

[API 사용 예제 다운로드]

연관 정보 바로가기

아래 가이드에서 연관 정보를 확인할 수 있습니다.

• GeoLocation 설명서