[Python] 네이버 Geocoding API를 사용하여 주소를 좌표로 변환하기

 

 

사용 라이브러리 
- requests
- pandas

 

지도에 공공데이터 포털에서 API로 받아온 장애인 구인 실시간 현황 데이터의 comAddr(회사주소)를 지도에 마커로 표시하기 위해 위도와 경도로 변환하여 테이블에 저장해 보려고 한다. 네이버 Geocoding API를 사용하여 주소를 좌표로 변환하는 방법이다. 

 

01. 네이버 Geocoding API 키 발급받기

먼저, 네이버 클라우드 플랫폼에서 Geocoding API를 사용하기 위해 API 키를 발급받아야 한다.

 

1. 네이버 클라우드 플랫폼에 접속하여 로그인한다.

2. 콘솔에서 Application 서비스의 애플리케이션 등록 메뉴로 이동, 새 애플리케이션을 등록한고 Geocoding API 사용을 활성화한다.

 

3. 발급된 클라이언트 ID와 클라이언트 시크릿을 확인한다.

이제 API 키를 발급받았으니, 파이썬 코드에서 이를 사용하여 Geocoding API를 호출하는 방법을 알아보겠다.

 

02. 파이썬 코드로 주소를 좌표로 변환하기

필요한 라이브러리 설치

먼저, HTTP 요청을 보내기 위해 requests 라이브러리를 설치한다.

pip install requests

 

네이버 Geocoding API를 사용하여 하나의 고정된 주소를 좌표로 변환하는 파이썬 코드를 작성해 보자.

import requests

# 네이버 API 키 설정
client_id = 'YOUR_CLIENT_ID'  # 네이버 클라우드 플랫폼에서 발급받은 클라이언트 ID
client_secret = 'YOUR_CLIENT_SECRET'  # 네이버 클라우드 플랫폼에서 발급받은 클라이언트 시크릿

# 고정 문자열 주소
address = '충청북도 청주시 흥덕구 산단로 54 한국폴리텍대학 청주캠퍼스'

# 네이버 Geocoding API 호출 함수 정의
def geocode_address(address):
    url = f"https://naveropenapi.apigw.ntruss.com/map-geocode/v2/geocode?query={address}"
    headers = {
        'X-NCP-APIGW-API-KEY-ID': client_id,
        'X-NCP-APIGW-API-KEY': client_secret
    }
    response = requests.get(url, headers=headers)
    if response.status_code == 200:
        data = response.json()
        if data['addresses']:
            location = data['addresses'][0]
            return location['y'], location['x']
        else:
            return None, None
    else:
        print(f"Error {response.status_code}: {response.text}")
        return None, None

# 주소를 좌표로 변환
latitude, longitude = geocode_address(address)

# 결과 출력
if latitude and longitude:
    print(f"주소: {address}")
    print(f"위도: {latitude}")
    print(f"경도: {longitude}")
else:
    print("좌표를 찾을 수 없습니다.")

 

코드 설명

1. requests 라이브러리를 사용하여 네이버 Geocoding API를 호출
2. 네이버 클라우드 플랫폼에서 발급받은 클라이언트 ID와 클라이언트 시크릿을 설정
3. 변환할 고정 문자열 주소를 address 변수에 저장
4. geocode_address 함수를 정의하여 주소를 입력받고, 네이버 Geocoding API를 호출하여 JSON 응답을 처리
5. 응답에서 위도(y)와 경도(x) 값을 추출하여 반환
6. 주소를 좌표로 변환한 후, 결과를 출력

 

03. 지도에서 결과 확인하기

실행 결과

 

변환된 위도와 경도를 네이버지도에 검색하여 제대로 변환된 것인지 확인해 보자. 

검색 결과 한국폴리텍대학 청주캠퍼스로 잘 나오는 것을 확인할 수 있다. 

 

04. 데이터프레임의 주소를 한 번에 좌표로 변환하기

위도와 경도가 잘 변환되는 것을 확인하였으니 이번에는 데이터프레임을 사용하여 여러 주소를 한 번에 좌표로 변환하여 위도, 경도 칼럼에 데이터를 추가해 보자.

import pandas as pd
import requests

# 네이버 API 키 설정
client_id = 'YOUR_CLIENT_ID'  # 네이버 클라우드 플랫폼에서 발급받은 클라이언트 ID
client_secret = 'YOUR_CLIENT_SECRET'  # 네이버 클라우드 플랫폼에서 발급받은 클라이언트 시크릿

# 네이버 Geocoding API 호출 함수 정의
def geocode_address(address):
    url = f"https://naveropenapi.apigw.ntruss.com/map-geocode/v2/geocode?query={address}"
    headers = {
        'X-NCP-APIGW-API-KEY-ID': client_id,
        'X-NCP-APIGW-API-KEY': client_secret
    }
    response = requests.get(url, headers=headers)
    if response.status_code == 200:
        data = response.json()
        if data['addresses']:
            location = data['addresses'][0]
            return location['y'], location['x']
        else:
            return None, None
    else:
        print(f"Error {response.status_code}: {response.text}")
        return None, None

# 데이터프레임에 위도와 경도 컬럼 추가
df['latitude'], df['longitude'] = zip(*df['compAddr'].apply(geocode_address))

 

코드 설명

1. pandas와 requests 라이브러리를 import 한다.
2. 네이버 클라우드 플랫폼에서 발급받은 클라이언트 ID와 클라이언트 시크릿을 설정한다.
3. geocode_address 함수를 정의하여 주소를 입력받고, 네이버 Geocoding API를 호출하여 JSON 응답을 처리한다.
4. 응답에서 위도(y)와 경도(x) 값을 추출하여 반환한다.
5. 데이터프레임의 comAddr 칼럼에 apply 메서드를 사용하여 각 주소에 대해 geocode_address 함수를 적용한다. 결과로 얻은 위도와 경도를 zip 함수로 풀어서 각각 latitude와 longitude 컬럼에 추가한다.

결과

latitude와 longitude 컬럼에 데이터가 잘 들어간 것을 확인할 수 있다.