Documentation for the scheme used for the OMT layer

General talk
1

The OMT layer in openstreetmap is the reference for implementing vector map style - but where is the docs for the actual scheme used??

I ask, because features show up that is not covered by the openmaptiles schema as presentet in the git repository at GitHub - openmaptiles/openmaptiles: OpenMapTiles Vector Tile Schema Implementation · GitHub - for example there are now trees in the map, but they are not in the schema.

Trees are fine, although there are lots of more valuable data that could be provided - but mainly, where is the docuementation for the schema? Maptiler documentation sucks, frankly - and there is no actual documentation for their schemas. It would be nice if open source was open!

1 Like
2

There’s still no clarity even on how the name tag works in OMT (see 1, 2, 3, 4) so I wouldn’t hold out much hope for trees!

1 Like
3

Thank you for answering. The name problems curious - I copyed style from the omt git, and got english names, where the omt layer on osm.org gives me danish names.

As for trees, they are probably not in the omt layer, but they are in the maptiler layers, along with some other things that it is hard to find documentation for. It would be nice if there were better coordination.

Trees are simple though, they are points with some data. ;)

4

Do you have an example? This tree doesn’t show up in the MapTiler OMT layer, which is based on MapTiler’s OpenMapTiles tileset. If you mean their MapTiler Planet v4 tileset, that’s proprietary, closed source, and not tied to the OpenMapTiles schema. The MapTiler Planet schema documentation does mention trees.

By the way, there are multiple implementations of the OpenMapTiles schema, including the original SQL implementation in openmaptiles-tools, a port to Java as a Planetiler profile, and of course the Tilemaker implementation that you maintain. These implementations are trying to maintain parity, but Planetiler accepts lots of configuration options allowing an individual deployment to depart from the schema as desired. It’s a workaround for a schema that has stalled.

MapTiler generates their OpenMapTiles tileset using Planetiler these days. For all I know, they pass in a lot of flags like OSMUS does for their tile service. Maybe they’ve made some private customizations too. In fact, I’m not sure who still relies on the much slower openmaptiles-tools anymore. The OMT maintainers have been hesitant to discontinue openmaptiles-tools, just in case someone is using it, but unfortunately that implementation is the most difficult to contribute to, hamstringing development of the schema.

1 Like
5

Yes, I found out that theese are not in the omt layer. It’s quite confusing sometimes to understand what goes on :\

I use tiles from openFreeMap, which are said to conform to the omt schema, and the data is completely (almost, no serious difference ime) similar to omt, except they lag behind as far as updates quite a bit. They use planetiler as well.

I really do not care about trees, but I would love for wetland to have subclasses (in a stable way), as well as for example docks. But I do not have the knowledge to provide patches for that, I don’t understand how the various files cooperates.

I prefer basing my style on the open schema.