Dear all,
We’ve added a new field to the image entity in the Graph API: on_foot.
It tells you whether an image was captured on foot (by a pedestrian) versus by another method such as a car or bicycle. It’s a nullable boolean:
- true — captured on foot (pedestrian)
- false — captured by another method (e.g. vehicle, bicycle)
- null — capture method hasn’t been classified
How to use it
Just add on_foot to your fields list on any image request:
curl “https://graph.mapillary.com/102353755423716?fields=id,on_foot&access_token=YOUR_ACCESS_TOKEN”
Response:
{
“id”: “102353755423716”,
“on_foot”: true
}
It also works anywhere a full image object is nested, e.g. fields=images.on_foot on a map feature, or in an image search:
For reference, API documentation is here: https://www.mapillary.com/developer/api-documentation#image
A note on accuracy 
on_foot is a model prediction, not a verified label. It’s correct roughly 90% of the time, so expect occasional misclassifications. Treat it as a strong signal rather than ground truth.
Feedback welcome — let us know how it works for your use cases!
