Matches Players Heatmaps
This endpoint allows you to retrieve the players heatmaps from matches. With the help of x, y and value fields you can see the players movements in the field.
Multi-language: This feature allows the user to manually change the language of the API response by adding value to the
lang
attribute. Example:lang=en
.
Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.
Update Period: The endpoint is updated every minute. Recommended Calls: Limit calls to 1 every minute.
Use Cases
Get player heatmaps from a specific match_idhttps://football.sportdevs.com/matches-players-heatmaps?match_id=eq.{match_id}
Get player heatmaps from a specific match_id and team_idhttps://football.sportdevs.com/matches-players-heatmaps?match_id=eq.{match_id}&team_id=eq.{team_id}
Get player heatmaps from a specific match_id, team_id and player_idhttps://football.sportdevs.com/matches-players-heatmaps?match_id=eq.{match_id}&team_id=eq.{team_id}&player_id=eq.{player_id}
Query Parameters
- match_id integer
Default value:
eq.1
The id of the match
- team_id integer
Default value:
eq.4225
The id of the team
- player_id integer
Default value:
eq.3858
The id of the player
- offset string
Default value:
0
Limiting and Pagination
- limit string
Default value:
50
Limiting and Pagination
- lang string
Default value:
en
Multi-language
- 200
OK
- application/json
- Schema
- Example (from schema)
Schema array
- match_id integer
The id of the match
Note: This is a Foreign Key to
injuries.match_id
. - team_id integer
The id of the team
Note: This is a Foreign Key to
teams.id
. - player_id integer
The id of the player
Note: This is a Foreign Key to
players.id
. - heatmaps jsonb
The heatmaps of the match
[
{
"match_id": 1,
"team_id": 4225,
"player_id": 3858,
"heatmaps": [
{
"x": 28,
"y": 8
},
{
"x": 29,
"y": 8
},
{
"x": 71,
"y": 29
},
{
"x": 71,
"y": 37
},
{
"x": 91,
"y": 4
},
{
"x": 97,
"y": 8
}
]
}
]