Documentation for using cateories taxonomy .csv

[lilcorey]

https://docs.overturemaps.org/schema/concepts/by-theme/places/#categories

categories column in Places does not contain the full taxonomy tree, only primary and alternate. E.g. {'primary': 'indian_restaurant', 'alternate': ['restaurant', 'fast_food_restaurant']}. In order to find all eat_and_drink I could build a metadata table from the .csv and use it to join eat_and_drink to rows containing more granular categories.

1. can the full taxonomy tree be included in categories column ?
2. alternatively, can examples be added to documentation to show how the full taxonomy can be leveraged in Places query filters?

[an-rose]

lilcorey the categories property will be deprecated from the schema in the Sept 2026 release: #434. basic_category and taxonomy properties were introduced to replace categories. Here's a description of the new properties: https://docs.overturemaps.org/guides/places/taxonomy/#comparing-the-original-and-new-properties.