shortbread-tiles / shortbread-docs

Documentation of the Shortbread vector tile schema
https://shortbread-tiles.org
Creative Commons Zero v1.0 Universal
28 stars 6 forks source link

Add policy and definition of what should be included in the POI layer #40

Open westnordost opened 8 months ago

westnordost commented 8 months ago

I believe there is an almost endless range of POIs that could be included in the POI layer.

If the shortbread schema is going to be used more, I predict lots of feature requests to add this or that POI to the list of POIs that should be present, plus of course discussions whether or not it satisfies any loosely or not loosely defined policy for inclusion. This will be hard.

So from the perspective of keeping the maintenance and also the possible points of contention low, the following solutions might be the best, though of course, they come each with obvious drawbacks:

  1. don't include POIs at all in the shortbread schema. This means no maintenance at all, but then, shortbread could not be a complete map as far as end user usage is concerned.

  2. policy-wise, only include POIs that are included in another OSM project, i.e. move the decision somewhere else. The most obvious would be the iD tagging schema and since it's maintenance is sponsored by OSMF, the current maintainer is very cautious to seek or wait for consensus on doubtful cases. JOSM presets or osm-carto (if it is then still maintained) would be options, too. All these options (except osm-carto) though do not solve the classification which map feature exactly should classify as a POI and which not. E.g. a traffic sign is certainly a map feature for which a preset exists or could exist, but it is not really a POI.

    We had a long discussion about this in StreetComplete. In the end, we settled towards having an overlay for "Places", roughly defined as "Map features like shops or amenities that usually have a name and can be entered" (=something you would enter into your car navigation). These are separate from "Things" shown in another overlay, like benches, bins, trees, lanterns, recycling, flagpoles. Anyway, policy-wise, we chose to write that places and things are only added to the list if they are already contained in the iD presets, to save us the prefiltering and discussion.

    EveryDoor, by the way, has a similar separation between places and things.

Do look at the links to the "Places" (and maybe "Things"), they contain many POIs I would consider should go into the POI overlay anyway. I just recently thoroughly researched this list via osm wiki and taginfo.

I could... create a feature request or PR for these, but I think it is important to settle on some form of inclusion policy and definition what exactly falls under a POI first.

pnorman commented 8 months ago

I could... create a feature request or PR for these

Any PR is going to have to go against a separate set of files for version 1.1 of the schema. I don't think we're ready to create that yet, and I know I'd like to get the bugs fixed in 1.0 before copying it to start 1.1