KoreaMarathonAPI

2017 Korea Marathon Events Web-Crawling

마라톤 온라인의 2017년도 마라톤 행사를 크롤링하여 API로 만들었습니다. 기존 정보 이외에 지도(위도, 경도), 다음지도URL, 기온, 날씨아이콘타입 정보를 제공합니다. 원 사이트에서 올바르지 않은 데이터가 있을 시, 지도정보(도시명, 위도, 경도)와 날씨정보(기온, 날씨아이콘)이 표시되지 않을 수 있습니다. 대회일시 기준으로 내림차순으로 되었습니다.

API는 아래 링크를 통해 조회 가능합니다.

• 전체 이벤트 : https://irunseoul-3204d.firebaseio.com/event.json
• 년간 이벤트 : https://irunseoul-3204d.firebaseio.com/event/2017.json

Response Values

Name	Type	Definition
title
host
email
date
phone
race
city
location
application_period
website
description
latitude
longitude
map_url
temperature
weather

{
    "title": "서울국제마라톤 겸 제88회 동아마라톤",
    "host": "동아일보사",
    "email": "marathon@donga.com",
    "date": "2017/03/19 08:00",
    "phone": "02-361-1425",
    "race": {
        "0": "풀",
        "1": "10km",
        "2": "2인릴레이",
        "3": "4인릴레이"
    },
    "city": "지역",
    "location": "서울광화문광장, 올림픽공원, 잠실주경기장",
    "application_period": "2016/12/12 - 2017/2/28",
    "website": "http://www.seoul-marathon.com",
    "description": "서울국제마라톤 겸 제88회 동아마라톤",
    "latitude": "37.5726574782299",
    "longitude": "126.97692131590603",
    "map_url": "http://map.daum.net/link/map/8193961",
    "temperature": "2.9°C",
    "weather": "clear-day"
}

날씨 아이콘

"weather" key에 해당하는 value로 SVG파일을 조회할 수 있습니다. (파일명: clear-day.svg) Reference. Skycons

Development

Built with Python3 Packages : beautifulSoup, requests, forecastio

How to setup and execute crawler

1. Go to your working directory and install Python virtual environment named marathonvenv

python3 -m venv marathonvenv

2. Activate Python virtual environment

source marathonvenv/bin/activate

3. Install Python Packages

pip3 install requests python-forecastio beautifulsoup4

4. Git clone this repository

git clone https://github.com/sujinleeme/KoreaMarathonAPI.git

5. Execute event_crawler.py

python3 event_crawler.py

TODO

Make Python script to fecth the Firebase’s REST API