mapillary / mapillary-python-sdk

A Python 3 library built on the Mapillary API v4 to facilitate retrieving and working with Mapillary data.
MIT License
37 stars 15 forks source link

[Utils] List of possible filter_values would be helpful #65

Open Rubix982 opened 3 years ago

Rubix982 commented 3 years ago

It can be useful to tell the user what kind of filter_values are possible when dealing with filtering the value in `properties.

For example, in #1, we see filter_values as,

# list of values to filter for and keep -- update this if changing to traffic signs
filter_values = ['object--support--utility-pole','object--street-light']

But I was unable to find this list of filter_values in the API docs.

This is related to #27 as we can check if the filter values given are correct, and alert the user if they've passed in the wrong filter values, and even provide as the mechanism for help as discussed in the Discord Chat (I can't find the issue that was made for this?). This is similar to #48 , but in the context of a help function.

Help needed, @cbeddow

cbeddow commented 3 years ago

The official list for now is under "traffic signs" and "point" here (points == map features in this context): http://web.archive.org/web/20210105003120if_/https://www.mapillary.com/developer/api-documentation/#traffic-signs http://web.archive.org/web/20210105003120if_/https://www.mapillary.com/developer/api-documentation/#points

This exact list should migrate to the new API docs soon but I cannot predict exactly when. Does this help for now? Maybe a text file is best to use with a fallback to scraping the website that we can switch to when these are live on the web?

Rubix982 commented 3 years ago

I agree with the file idea, we can scrap it pretty easily and keep it for checking locally, then move to remote API checking when it's finished on the API's end.

Rubix982 commented 2 years ago

This would need to be shifted to the documentation as well.

eneerhut commented 2 months ago

Traffic sign list. Point feature list.