[API] 세계 각국의 기본 정보 가져오기 (restcountries)

직구가 필요한 물건이 있어서 해외사이트에 회원가입을 진행했습니다. 가입 진행 절차에 국가를 입력하는 부분이 있었는데, 문득 개발자들은 이런 정보를 어디서 가져오는지가 궁금해졌습니다. 제가 또 궁금한 것은 못 참는 성격이라 바로 구글링을 했고, restcountries라는 API를 제공하는 무료 사이트를 발견했습니다:

https://restcountries.com/#api-endpoints-v2-list-of-codes

총 250개 국가에 대한 정보를 REST API로 제공

 

각국의 명칭, 국가코드, 통화, 위성좌표, 사용 언어 등의 국가에 대한 기본 정보가 담겨있는 API를 제공하는 사이트입니다. 그래서 한번 탐색을 해보기로 했습니다. (별도의 API Key를 발급할 필요가 없습니다)

 

대한민국 정보 가져오기

아래의 코드를 입력하면 한국의 정보를 가져옵니다. 대한민국과 북한의 정보를 둘다 가져와서 'South Korea' 혹은 'Republic of Korea'라고 검색을 해야 할 것 같습니다. Native name도 지원을 한다고 해서 '대한민국', '한국'으로 검색도 해봤는데 404 에러가 뜨는 걸 보니 검색이 완벽하지는 않은 것 같습니다 ㅎㅎ

import requests

country = 'korea'
url = f'https://restcountries.com/v3.1/name/{country}'
req = requests.get(url)
json_data = req.json()

REST API로 가져온 대한민국 json 데이터

 

가져온 정보가 생각보다 방대해서 놀랐습니다. 우선 제공하는 항목은 다음과 같습니다:

dict_keys(['name', 'tld', 'cca2', 'ccn3', 'cca3', 'cioc', 'independent', 'status', 'unMember', 'currencies', 'idd', 'capital', 'altSpellings', 'region', 'subregion', 'languages', 'translations', 'latlng', 'landlocked', 'borders', 'area', 'demonyms', 'flag', 'maps', 'population', 'gini', 'fifa', 'car', 'timezones', 'continents', 'flags', 'coatOfArms', 'startOfWeek', 'capitalInfo', 'postalCode'])

인구, 수도, 통화, 국가 코드, 국기 이미지 등 다양한 정보를 제공하고 있어서 국제사회 연구를 하는 분들에게는 아주 유용할 것 같습니다.

 

250개국의 수도 정보 가져오기

퀴즈하면 빠질 수 없는 것이 국가의 수도에 대한 질문입니다. 이번에는  restcountries의 API를 활용하여 각국의 수도 데이터를 가져와보겠습니다.

import requests
import pandas as pd

url = f'https://restcountries.com/v3.1/all'
req = requests.get(url)
json_data = req.json()

def extract_capital(x):
    if x:
        return x[0]
    else:
        return None

    
def extract_coord(x):
    if x.keys():
        return x['latlng']
    else:
        return [None,None]


# json 데이터 전처리
capital_df = pd.DataFrame(json_data)[['name','capital','capitalInfo']]
capital_df = capital_df.fillna("")
capital_df['country'] = capital_df['name'].apply(lambda x: x['common'])
capital_df['capital'] = capital_df['capital'].apply(lambda x: extract_capital(x))
capital_df['coord'] = capital_df['capitalInfo'].apply(lambda x: extract_coord(x))
capital_df = capital_df[['country','capital','coord']]

capital_df

데이터 조회 결과

각 국가의 수도 이름과 좌표까지 잘 나오는 것을 확인할 수 있습니다. 데이터 정합성을 위해 구글 맵을 이용 하여 좌표를 찍어보도록 하겠습니다. 맨 마지막에 조회되는 자메이카의 위도와 경도 정보를 구글맵에 입력을 했고, 킹스턴의 위치가 잘 나오는 것을 확인했습니다:

데이터 정합성 Google Map으로 체크

 

 

250개국의 국기 이미지 가져오기

데이터를 살펴본 결과 총 250개의 국가에 대한 정보가 있는 것을 확인해보겠습니다. 이번에는 각 국가의 국기 이미지를 가져와보도록 하겠습니다.

import requests
import os
from PIL import Image
from io import BytesIO


url = f'https://restcountries.com/v3.1/all'
req = requests.get(url)
json_data = req.json()

# 국가 이름 가져오기
country_data = [c['name']['common'] for c in json_data]

# 국기 이미지 파일 URL 가져오기
flag_png_url_data = [c['flags']['png'] for c in json_data]

# 국기 이미지 파일 저장 디렉토리 지정
save_dir = '/Users/jake1/Desktop/flag_imgs/'

# 국기 이미지 파일 다운로드
def get_png_files(country,url, save_dir):
    png_file = requests.get(url).content
    im = Image.open(BytesIO(png_file))
    im.save(save_dir + country + '.png')
    return

# 250개 국가의 국기 이미지 파일 다운로드 실행
for country, url in zip(country_data, flag_png_url_data):
    get_png_files(country,url,save_dir)

# 저장된 이미지 파일 개수 확인
print(len([f for f in os.listdir(save_dir) if f.endswith('.png')]))

# 캐나다 국기 가져오기 (Ipynb 노트북에서만 작동)
canada_flag = save_dir + 'Canada.png'
im = Image.open(canada_flag)
display(im)

코드 결과창

캐나다 국기가 성공적으로 불러와졌습니다. 또한 save_dir로 지정한 폴더 내 이미지들이 아래와 같이 저장이 잘 되어있습니다. 이로써 일일이 구글에 각 국가별로 국기 이미지를 수집할 필요가 없어졌습니다.

결과 폴더에 다운로드 된 국기 이미지 일부 목록

---

마무리

이번 포스팅에서는 각 국가에 대한 정보를 제공하는 rest countries의 API를 활용해 봤습니다. 무료로 운영을 하고 있으며 많은 트래픽 요청을 별다른 수익 없이 처리하고 있으니 드는 비용이 상당할 것으로 추정됩니다. 여유가 있으신 분들은 커피 한잔 값이라도 보내주시면 개발 커뮤니티에 큰 도움이 될 것 같습니다.

 

IT 업계가 빠른 속도로 발전을 한 것도 오픈소스와 무료 API를 제공하는 사람들이 있었기 때문에 가능한 것 같습니다. 훗날 저도 서버를 하나 운영해서 유용한 정보를 API로 제공해보고 싶어 졌습니다. 그럼 오늘은 여기서 마무리하도록 하겠습니다.

 

잘 보셨다면 댓글이나 공감 꾹~ 눌러주시길 바랍니다!