Proposed features/Top up

From OpenStreetMap Wiki
Jump to: navigation, search
Top up
Status: Voting (under way)
Proposed by: Danysan
Tagging: prepaid_top_up=‹type›
Applies to: node, area
Definition: Whether a bar/store/... sells top-ups for prepaid services
Drafted on: 2018-12-25
RFC start: 2018-12-25
Vote start: 2019-01-09
Vote end: 2019-01-23


Introduce the keys prepaid_top_up=*, prepaid_top_up:brand=* and prepaid_top_up:network=* to specify whether a store sells top-ups for prepaid services.


If you are unfamiliar with the concept of prepaid services you can check out this Wikipedia page.

With "top-up" I refer to a recharge for the credit of a prepaid service. This includes:

Right now in OpenStreetMap only vending machines can sell mobile phone vouchers (amenity=vending_machine + vending=telephone_vouchers).

This neglects some top-ups, like public transport credit. Also, in the real world top-ups can be sold in other shops, such as:

I propose to introduce these tags to specify whether a store sells top-ups:

tag Meaning
prepaid_top_up=yes Top ups are sold here
prepaid_top_up=‹type› <type> can be mobile_phone, public_transport, energy, credit cards, ... . Top ups for this type of service are sold here.
prepaid_top_up=no Top ups are not sold here.
prepaid_top_up:brand=‹brand› <brand> is the name of a brand. Top ups for this brand are sold here.
prepaid_top_up:network=‹network› <network> is the name of a payment services network. Top ups through this network are sold here. Note that a payment services network is not a payment network (as in payment=*). It's a network that allows to pay multiple services (including top ups) in the same place. An example is PayPoint.

Historic notes

Doing some research for this proposal I found a 2015 discussion in the Tagging mailing list that asked how to tag recharge point for public transportation credit and proposed the key recharge=*, but it seems that it did not have much success.

top_up=* has never been discussed on the wiki or the Tagging mailing list but it looks like it's already used, mainly in the Birmingham area for the Swift card.

paypoint=* has also never been discussed but it looks like it's already used to specify that the aforementioned PayPoint network is present in a shop. The same holds true for pay_point=*.

A 2018 discussion in the Talk-it mailing list on how to map shops that sell mobile phone credit recharges moved me to create this proposal.

Originally this proposal proposed to formalize the key top_up=* to specify whether top-ups are sold in a shop. It would be possible to specify which brand/carrier vouchers are sold with the key brand=*. However this would create a conflict because brand=* is already used in the shops to specify their main brand.

A second revision of this proposal proposed the tags top_up:<type>[:<brand>]=yes/no:

This approach however posed some problems:

  • Some networks (like PayPoint) allow top-up more than one service (mobile phone, public transport, ...)
  • The scheme has a over-namespacing problem because both the second and the third subkeys could be values
  • The name "top_up" can be confused with drink refill and is unclear for people of countries where prepaid services are not widespread
  • Brand names are likely to use characters such as upper-case letters or non-ASCII characters that should be avoided in keys where possible

The actual scheme solves all these problems


Example Tags
Store that offers phone credit top-up
shop=* + prepaid_top_up=mobile_phone + prepaid_top_up:brand=Digicel;LIME
amenity=bar + prepaid_top_up=public_transport + prepaid_top_up:brand=Opal
amenity=vending_machine + vending=public_transport_tickets + prepaid_top_up=public_transport + prepaid_top_up:brand=Opal
shop=* + prepaid_top_up=public_transport + prepaid_top_up:brand=M Card
Payment network that allows to top-up phone and energy credit
shop=* + prepaid_top_up=mobile_phone;energy;public_transport + prepaid_top_up:network=PayPoint


Applies to

Nodes and areas.

Features/Pages affected

External discussions


Please comment on the discussion page.


Instructions for voting
  • Log in to the wiki if you are not already logged in.
  • Scroll down to voting and click 'Edit source'. Copy and paste the appropriate code from this table on its own line at the bottom of the text area:
I approve this proposal yes {{vote|yes}} --~~~~
I oppose this proposal no {{vote|no}} reason --~~~~
Replace reason with your reason(s) for voting no.
I abstain from voting but have comments abstain {{vote|abstain}} comments --~~~~
If you want don't want to vote but have comments. Replace comments with your comments.

Note: The ~~~~ automatically inserts your name and the current date.

  • I approve this proposal I approve this proposal. --EneaSuper (talk) 10:47, 21 January 2019 (UTC)
  • I abstain from voting but have comments I have comments but abstain from voting on this proposal. It is unclear to me how one is supposed to tag place selling multiple top ups with separate purposes - for example prepaid for mobile phones of brand A and separate unrelated prepaid for public transport from unrelated brand and network --Mateusz Konieczny (talk) 17:38, 9 January 2019 (UTC)
If a shop sells top ups for mobile phones of brand A and top ups for public transport of brand B you would use shop=*+prepaid_top_up=mobile_phone;public_transport+prepaid_top_up:brand=A;B -Danysan (talk) 09:41, 10 January 2019 (UTC)
  • I approve this proposal I approve this proposal. --Dr Centerline (talk) 02:33, 11 January 2019 (UTC)
  • I abstain from voting but have comments I have comments but abstain from voting on this proposal. I actually like the proposal, but i think it would have been simpler to tag payment service network top-ups (like PayPoint) with prepaid_top_up:brand=<payment service network> as the payment service is also brand. –SelfishSeahorse (talk) 11:47, 12 January 2019 (UTC)
  • I oppose this proposal I oppose this proposal. The proposal goes to a level of detail that induces to nano-mapping, producing large quantities of very perishable data. I would at least explicitly discourage the "brand" level-of-detail --voschix (talk) 14:42, 12 January 2019 (UTC)
I agree that the list of sold top up brands is perishable, but so is the list of sold beer brands and yet its tag exists (brewery=*) and is widely used. What's the criteria to decide that a feature is too perishable? -Danysan (talk) 09:29, 14 January 2019 (UTC)
  • I approve this proposal I approve this proposal. --AgusQui (talk) 03:54, 17 January 2019 (UTC)
  • I approve this proposal I approve this proposal. --Jmdocile (talk) 11:51, 17 January 2019 (UTC)
  • I approve this proposal I approve this proposal. -- Santamariense (talk) 02:00, 20 January 2019 (UTC)