Import/Qerko Businesses
This is still a draft, not even suitable for proper discussion
About
Qerko Businesses is an import of Qerko s.r.o. dataset containing tags related to bitcoin payments. Qerko s.r.o. is a company that offers services to restaurants (not only, but mostly), such as fast QR payments, order processing, and reservation management.
Goals
Import tags related to btcmap. Qerko s.r.o. provides Bitcoin lightning payments, and this import introduces essential tags required for btcmap's functionality. At the same time, it eliminates these tags when a restaurant discontinues Bitcoin acceptance through Qerko. Essentially, this import ensures the synchronization of this data. The tag format was collaboratively chosen with the btcmap community.
Schedule
As soon as possible. The import script is ready to go for the first batch. Subsequently, our goal is to synchronize updates on a weekly basis
Import Data
Background
Type of license (if applicable): MIT
Import Type
This is a recurring import.
Data Preparation
Data Reduction & Simplification
This import eliminates unnecessary re-imports by comparing live data with the internal database. It updates only tags described below and in case of difference.
Tagging Plans
Every changeset will encompass all modifications since the previous run. This implies that the initial execution will be huge, but subsequent runs will be relatively small. This behavior can be easily adjusted based on input from the OSM community.
The dataset will be in XML format and it will be merged and uploaded with current live data from OpenStreetMap data automatically.
Linking between the internal Qerko database and OSM relies on node ID which is maintained manually by the internal Qerko account team. To prevent bugs in pairing the script compares GPS coordinates of the OSM node and Qerko data.
Changeset Tags
| Key | Value | Comment |
|---|---|---|
| payment:lightning:requires_companion_app | yes | This implies that you'll need to utilize a third-party app for Bitcoin lightning payments. |
| payment:lightning:companion_app_url | https://www.qerko.com | URL link to obtain the app. |
| currency:XBT | yes | It signifies that this business accepts Bitcoin as a payment method. |
Data Merge Workflow
Team Approach
The import script is developed and maintained by Qerko developers. All changes in the script go through the code review.
This is a list of people who are working on the import:
QA
The import script undergoes automatic testing using the HTTP snapshot file, ensuring consistent XML structure for all our API calls over time.
See also
- Qerko s.r.o. website
- Discussion with btcmap community, 11 Jun 2023