[iOS/API] 네이버 API를 이용해서 주소를 위도,경도로 변환하기(NAVER CLOUD PLATFORM GEOCODING)

안녕하세요 Foma 입니다!

 

오늘은 네이버 클라우드 플랫폼에 있는 Geocoding 을 이용해서 원하는 주소의 위도,경도값을 받아올거에요!

 

애플에서 제공하는 지오코딩도 있지만 한국 주소를 입력하면 잘못된 정보가 꽤 많이 나오더라구요.

 

구글 API를 사용해야하나...? 고민하는데 구글은 2만회까지 무료고 그 이상되면 유료로 지불해야 되더라구요.

 

혹시나 하고 네이버 클라우드 플랫폼 을 들어가봤더니... 300만회까지 무료....😍

 

고민할거 없이 바로 네이버 클라우드 플랫폼 을 이용하기로 했습니다.

 

바로 시작할게요~!!

 

---

NAVER CLOUD PLATFORM

 

네이버 클라우드 플랫폼으로 이동해주세요!

NAVER CLOUD PLATFORM

오른쪽 상단에 보시면 로그인이 있을거에요.(저는 로그인한 상태라 로그아웃으로 보입니다.)

 

여기서 네이버 클라우드 플랫폼 전용 아이디를 회원가입 해줍니다.

 

 

회원가입을 마치셨으면 로그아웃 바로 아래쪽에 Console 이라고 있는데요. 여기를 클릭해서 들어가주세요.

 

들어가시면 왼쪽에 AI-NAVER API를 클릭하시면 Application이 나올텐데 눌러주세요!

그러면 아래와 같은 화면이 나올텐데 + Application 등록을 눌러주세요!

 

아래와 같이 정말 많은 API가 있어요.

 

이 중에서 우리는 Maps에 Geocoding을 눌러줍니다.

 

그리고 아래에 iOS Bundle에 프로젝트 번들이름을 넣어주세요! (+추가 버튼을 누르셔야 추가됩니다.)

그리고 등록버튼을 누르면 아래와 같이 Geocoding 서비스를 사용할 수 있는 앱이 나옵니다.

위 사진에서 App 이름 아래 인증 정보라고 있는데요.

 

이걸 클릭하면 Client ID와 Client Secret이 나옵니다. 

 

API 이용에 필요하니 반드시 어디에 저장해두세요!

이제 본격적으로 geocode 설명서를 보면 요청은 아래와 같이 한다고 나와있어요.

 

저한테는 익숙하지 않아서 무슨 말인지 모르겠더라구요.... 아까 저장해놓은 클라이언트 아이디하고 시크릿이 필요한거 같은데...

 

-data-urlencode 는 뭐고... -H는 뭐야... 어떤식으로 넣어야해....

 

curl -G "https://naveropenapi.apigw.ntruss.com/map-geocode/v2/geocode" \
    --data-urlencode "query={주소}" \
    --data-urlencode "coordinate={검색_중심_좌표}" \
    -H "X-NCP-APIGW-API-KEY-ID: {애플리케이션 등록 시 발급받은 client id값}" \
    -H "X-NCP-APIGW-API-KEY: {애플리케이션 등록 시 발급받은 client secret값}" -v

 

뭐 이런식으로 요청하면 아래와 같이 JSON 형태로 데이터를 받을 수 있다고 하네요!

 

{
    "status": "OK",
    "meta": {
        "totalCount": 1,
        "page": 1,
        "count": 1
    },
    "addresses": [
        {
            "roadAddress": "경기도 성남시 분당구 불정로 6 그린팩토리",
            "jibunAddress": "경기도 성남시 분당구 정자동 178-1 그린팩토리",
            "englishAddress": "6, Buljeong-ro, Bundang-gu, Seongnam-si, Gyeonggi-do, Republic of Korea",
            "addressElements": [
                {
                    "types": [
                        "POSTAL_CODE"
                    ],
                    "longName": "13561",
                    "shortName": "",
                    "code": ""
                }
            ],
            "x": "127.10522081658463",
            "y": "37.35951219616309",
            "distance": 20.925857741585514
        }
    ],
    "errorMessage": ""
}

 

 

구체적인 파라미터들을 살펴보고 싶으신 분들은

 

아래 geocode 설명서로 이동하셔서 확인해주세요!

 

geocode - API 참조서

---

Xcode

 

자 이제 본격적으로 프로젝트로 이동해서 코드를 세팅해봅시다!

 

먼저 저는 네트워크 통신을 하기 위해 Alamofire라는 라이브러리와 JSON을 파싱하기 위해 SwiftyJSON이라는 라이브러리를 사용했습니다.

 

pod파일에 아래와 같이 두 라이브러리를 추가해주세요! (버전은 다를수도 있으니 확인해주세요)

pod 'Alamofire', '~> 5.2'
  
pod 'SwiftyJSON', '~> 4.0'

---

ViewController

 

뷰컨트롤러로 이동해서 두 라이브러리를 import 해줍니다.

import Alamofire
import SwiftyJSON

 

가장 먼저 네이버 API 변수들을 세팅해줄거에요.

 

위에서 저장해준 네이버 클라이언트 아이디와 시크릿 그리고 지오코드 url을 세팅해줍니다.

   let NAVER_CLIENT_ID = "네이버 클라이언트 아이디"
   let NAVER_CLIENT_SECRET = "네이버 클라이언트 시크릿"
   let NAVER_GEOCODE_URL = "https://naveropenapi.apigw.ntruss.com/map-geocode/v2/geocode?query="

 

그리고 원하는 주소를 만들어주고 그 주소를 encoding한 주소를 만들어줍니다.

 

 let 홍대입구역 = "서울시 마포구 동교동"
 let encodeAddress = 홍대입구역.addingPercentEncoding(withAllowedCharacters: .urlHostAllowed)!

 

네이버 클라이언트 아이디와 네이버 클라이언트 시크릿을 HTTPHeader로 각각 만들어주고

 

HTTPHeaders안에 두 헤더를 배열에 담아 넣어주세요.

 

   override func viewDidLoad() {
        super.viewDidLoad()
        
        let header1 = HTTPHeader(name: "X-NCP-APIGW-API-KEY-ID", value: NAVER_CLIENT_ID)
        let header2 = HTTPHeader(name: "X-NCP-APIGW-API-KEY", value: NAVER_CLIENT_SECRET)
        let headers = HTTPHeaders([header1,header2]) 
        ...

그 아래에 Alamofire를 사용해서 네이버 지오코드 url에 encode한 주소를 합쳐서 넣어주고 method 는 GET방식으로

 

headers에 위에서 만들어준 headers를 넣어준 뒤 JSON 방식으로 응답 요청을 보냅니다.

 

결과가 성공적으로 왔다면 JSON으로 온 결과를 SwiftyJSON 라이브러리를 사용해서 딕셔너리 형태로 바꿔줍니다.

 

위 JSON 결과를 보면 addresses 의 큰 묶음 안에 위도는 x로 경도는 y로 되어있습니다.

 

고로 data를 json["addresses"]로 넣어준 뒤 y를 위도, x를 경도로 각각 저장해줍니다.

    AF.request(NAVER_GEOCODE_URL + encodeAddress, method: .get,headers: headers).validate()
        .responseJSON { response in
            switch response.result {
            case .success(let value as [String:Any]):
                let json = JSON(value)
                let data = json["addresses"]
                let lat = data[0]["y"]
                let lon = data[0]["x"]
                print("홍대입구역의","위도는",lat,"경도는",lon)
            case .failure(let error):
                print(error.errorDescription ?? "")
            default :
                fatalError()
            }
        }

 

출력한 것을 확인해보면 아래와 같이 잘 출력되는 것을 볼 수 있습니다!

 

한번 제대로 나왔는지 확인해봐야겠죠?

---

Google Map

 

먼저 구글맵으로 이동해주세요!

 

Google 지도

위에서 나온 위도와 경도를 검색해주면

 

 

아래와 같이 정확히 홍대입구역은 아니지만 (서울시 마포구 동교동이라고 검색해서 그렇습니다.)

 

홍대입구역 근처 좌표가 찍히는걸 볼 수 있습니다 !!

---

오늘은 이렇게 네이버 클라우드 플랫폼을 활용해서 주소의 위도 경도를 알아오는 법에 대해서 알아보았습니다.

 

혹시라도 틀린 부분이 있거나 지적해주실 부분이 있다면 댓글로 알려주세요!