Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wingkwong/hk-atm-locator
:atm: 香港自動櫃員機定位器 :atm: Centralising Automated Teller Machine (ATM) Data in Hong Kong in a well-defined yet standardised format and display in a web portal for public use
https://github.com/wingkwong/hk-atm-locator
atm data-enrichment data-scraping data-transformation hk-atm-locator hong-kong-atm open-api
Last synced: about 2 months ago
JSON representation
:atm: 香港自動櫃員機定位器 :atm: Centralising Automated Teller Machine (ATM) Data in Hong Kong in a well-defined yet standardised format and display in a web portal for public use
- Host: GitHub
- URL: https://github.com/wingkwong/hk-atm-locator
- Owner: wingkwong
- Created: 2019-03-02T09:47:47.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-12-15T05:48:06.000Z (about 1 year ago)
- Last Synced: 2024-10-31T07:51:32.256Z (2 months ago)
- Topics: atm, data-enrichment, data-scraping, data-transformation, hk-atm-locator, hong-kong-atm, open-api
- Language: JavaScript
- Homepage: https://wingkwong.github.io/hk-atm-locator
- Size: 11.1 MB
- Stars: 17
- Watchers: 3
- Forks: 7
- Open Issues: 36
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Hong Kong Automated Teller Machine (ATM) Locator
### Project Synopsis
There are three ATM networks in Hong Kong, which are HSBC, Hang Seng Bank and JETCO respectively. ATM data will be retrieved via API Portal from HSBC, Hang Seng Bank and APIX. However, the interoperability is frustrating as the API is implemented at different standard levels. Hence, this project aims to centralise Hong Kong ATM data in a well-defined yet standardised format and display in a web portal for public use.
Hong Kong Monetary Authority (HKMA) has published [Open API Framework for the Hong Kong Banking Sector](https://www.hkma.gov.hk/media/eng/doc/key-information/press-release/2018/20180718e5a2.pdf), mentioning that no standardised open API functions will be provided at the first release.
Paragraph #20
> Throughout the discussion and consultation period, the HKMA recognises the industry’s desire to see a common set of Open APIs for better interoperability. However, a number of international banks operating in Hong Kong have already implemented their group standard for implementing Open APIs at global or regional levels, and have demonstrated elsewhere that requiring banks to adhere to a prescribed set of standardised Open API functions is challenging.
Paragraph #21
> Some opinions from the technology sector also indicate that it would be more desirable for banks to quickly offer Open APIs than to wait for standardised Open APIs that would take time to emerge. Furthermore, it is believed that once an ecosystem has been developed and becomes mature, convergence to standardised Open APIs will likely occur in response to the needs of the market.
---
## Project Roadmap
### Phase I
- [x] Retrieving ATM data from HSBC and Hang Seng Banks from API Portals
- [ ] Retrieving ATM data from APIX
- [ ] Bank of China (Hong Kong) Limited
- [x] Bank of Communications (Hong Kong) Limited
- [x] Bank of Communications Co., Ltd.
- [x] China CITIC Bank International Limited
- [x] China Construction Bank (Asia) Corporation Limited
- [x] China Merchants Bank Hong Kong Branch
- [ ] Chiyu Banking Corporation Limited
- [x] Chong Hing Bank Limited
- [ ] Citibank (Hong Kong) Limited
- [x] CMB Wing Lung Bank Limited
- [ ] Dah Sing Bank, Limited
- [ ] DBS Bank (Hong Kong) Limited
- [x] Fubon Bank (Hong Kong) Limited
- [x] Industrial and Commercial Bank of China (Asia) Limited
- [ ] Nanyang Commercial Bank Limited
- [x] OCBC Wing Hang Bank Limited
- [ ] Public Bank (Hong Kong) Limited
- [ ] Shanghai Commercial Bank Limited
- [ ] Standard Chartered Bank (Hong Kong) Limited
- [x] The Bank of East Asia, Limited
### Phase II
- [ ] Data Transformation & Enrichment
- [ ] Web Portal Development
---
## Contributions
We are looking for technical & non-technical contributors:
Technical Contributors:
- Responsible for implementing features and fixing reported bugs
- Preferably with experience with knowledge in Open API and Web Development
Non-technical Contributors:
- Responsible for updating documentation
- Good command of written in English and Chinese
UI/UX Contributors:
- Responsible for refining UI/UX
- Knowledge of UI/UX principles and techniques
If you are interested, please join the telegram group for further discussion.
---
### Links
HK ATM Locator:
https://wingkwong.github.io/hk-atm-locator/
Telegram:
https://t.me/joinchat/I_FIgxaIhCVeWKp1JKcMGQ
Trello:
https://trello.com/b/FfBaG2b6/hk-atm-locator
Collaction:
https://www.collaction.hk/s/hk-atm-locator
---
## Licensed Banks Incorporated in Hong Kong
| Clearing Code | Bank Name | Chinese Name |
|--------------- |------------------------------------------------ |-------------------------------- |
| 003 | Standard Chartered Hong Kong | 渣打銀行(香港)有限公司 |
| 004 | Hongkong and Shanghai Banking Corporation | 香港上海滙豐銀行有限公司 |
| 009 | China Construction Bank (Asia) | 中國建設銀行(亞洲)股份有限公司 |
| 012 | Bank of China (Hong Kong) | 中國銀行(香港)有限公司 |
| 015 | The Bank of East Asia, Limited | 東亞銀行有限公司 |
| 016 | DBS Bank (Hong Kong) | 星展銀行(香港)有限公司 |
| 018 | China CITIC Bank International | 中信銀行國際有限公司 |
| 020 | Wing Lung Bank | 永隆銀行有限公司 |
| 024 | Hang Seng Bank | 恒生銀行有限公司 |
| 025 | Shanghai Commercial Bank | 上海商業銀行有限公司 |
| 027 | Bank of Communications (Hong Kong) | 交通銀行(香港)有限公司 |
| 028 | Public Bank (Hong Kong) | 大眾銀行(香港)有限公司 |
| 035 | OCBC Wing Hang Bank | 華僑永亨銀行有限公司 |
| 038 | Tai Yau Bank | 大有銀行有限公司 |
| 039 | Chiyu Banking Corporation | 集友銀行有限公司 |
| 040 | Dah Sing Bank | 大新銀行有限公司 |
| 041 | Chong Hing Bank | 創興銀行有限公司 |
| 043 | Nanyang Commercial Bank | 南洋商業銀行有限公司 |
| 061 | Tai Sang Bank Limited | 大生銀行有限公司 |
| 072 | Industrial and Commercial Bank of China (Asia) | 中國工商銀行(亞洲)有限公司 |
| 128 | Fubon Bank (Hong Kong) | 富邦銀行(香港)有限公司 |
| 250 | Citibank (Hong Kong) | 花旗銀行(香港)有限公司 |