hko 0.2.0

An unofficial Python wrapper for public API of Hong Kong Observatory

python-hko

A python warpper for getting Hong Kong SAR local weather from Hong Kong Observatory Open Data API. Please refer to the Official Documentation for request parameters and response details. Official API Documentation

Reference

HKO Module

hko.HKO(websession) Manage and perform requests Return: hko.HKO class

Parameter	Optional	Type	Description
websession	no	ClientSession	see aiphttp

hko.HKO.weather(type, lang="en") Retrieve weather data from Weather Information API Return: dictionary

Parameter	Optional	Type	Description	Accepted values
dataType	no	string	type of data requested	see Official API Documentation
lang	yes	string	language used in response	see Official API Documentation

Usage Example

Get and print local weather forcast general situation in English

from hko import HKO
import asyncio
from aiohttp import ClientSession, ClientResponse
from aiohttp import ClientConnectorError

async def main():
    async with ClientSession() as websession:
        try:
            hko = HKO(websession)
            fnd = await hko.weather("fnd")
            print(fnd["generalSituation"])
        except ClientConnectorError as error:
            print(error)

loop = asyncio.get_event_loop()
loop.run_until_complete(main())
loop.close()