A Python package aimed easy abstraction of the Cultural Heritage API provided by the Cultural Heritage Administration of Korea.
Project description
KHeritageAPI
KHeritageAPI is a Python wrapper designed to facilitate efficient and accurate access to Korea's rich cultural heritage data. It simplifies the process of querying and interpreting data from Korea's Cultural Heritage API, making it an invaluable tool for developers and researchers globally.
Development Status
This project is currently under active development. While core functionalities are being implemented and tested, the package is not yet available on PyPI. Stay tuned for updates and the official release.
Features
- Easy-to-use interface for accessing Korea's Cultural Heritage API.
- Structured response handling for efficient data manipulation.
- Comprehensive enumeration for types, provinces, and city codes.
- Ongoing development and support for additional API functionalities.
Installation
pip install kheritage
Usage
Here's a basic example of how to use the KHeritageAPI to perform a search:
from kheritage import api, models
# Search for 15 historic sites in Seoul's Jongno district
search = Search(result_count=15, city_code=CityCode.SEOUL, district_code=Seoul.JONGNRO, canceled=False,
heritage_type=HeritageType.HISTORIC_SITE)
result = search.commit_search()
# Get detailed information on the first item
detail = ItemDetail(result.items[0])
detail_info = detail.info()
print(detail_info)
# Also, you can get images and videos of the item
images = detail.image()
print(images)
videos = detail.video()
print(videos)
# Search for events in 2023, December
event_search = EventSearch(2023, 12)
events = event_search.commit_search()
for event in events:
print(event)
Contributing
Contributions to KHeritageAPI are welcome. If you're interested in contributing, please fork the repository and submit a pull request with your changes.
License
This project is licensed under the MIT License.
Acknowledgements
Developed with the enthusiasm of Jay Suh (jay@joseon.space) from the non-profit organization Joseon Space (joseon.space). This module aims to provide easy access to Korea's cultural heritage for developers and researchers around the world.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for kheritage-0.0.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 63fdb23c11c2f7f9a69efa31315ec94fbad302cbd3867e72942ed7fe5e769593 |
|
MD5 | 4af69937dc84e70f84a1234a485e414d |
|
BLAKE2b-256 | 70dfff1d5bf99524872cd694330a76bf66299c26f08c4efe36a38037b912615a |