Skip to main content

Matches Shotmap​

This endpoint allows you to retrieve shot maps for an match.

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 per minute.

Use Cases​

Get shot map from a specific player_id
https://football.sportdevs.com/matches-shotmap?player_id=eq.{player_id}

Get shot map from a specific match_id
https://football.sportdevs.com/matches-shotmap?match_id=eq.{match_id}

Get shot map from a specific player_id and match_id
https://football.sportdevs.com/matches-shotmap?player_id=eq.{player_id}&match_id=eq.{match_id}

Query Parameters
  • id integer

    Default value: eq.1

    The id of the shotmaps

  • match_id integer

    Default value: eq.12

    The id of the match

  • player_id integer

    Default value: eq.533

    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

Responses

OK

Schema array
  • id integer

    The id of the shotmaps

    Note: This is a Primary Key.

  • match_id integer

    The id of the match

    Note: This is a Foreign Key to injuries.match_id.

  • player_id integer

    The id of the player

    Note: This is a Foreign Key to players.id.

  • player_name text

    The name of the player

  • player_hash_image character varying

    Possible values: <= 64 characters

    The name image of the player

  • is_home_team boolean

    If the player is playing at his home arena

  • shot_type text

    The type of the shot

  • situation text

    The situation

  • player_coord_x numeric

    The x coordinates of the player [0-100]

  • player_coord_y numeric

    The y coordinates of the player [0-100]

  • player_coord_z numeric

    The z coordinates of the player [0-100]

  • body_part text

    The left or right foot

  • goal_mouth_location text

    The location of the goal mouth

  • goal_mouth_coord_x numeric

    The x coordinates of the goal mouth [0-100]

  • goal_mouth_coord_y numeric

    The y coordinates of the goal mouth [0-100]

  • goal_mouth_coord_z numeric

    The z coordinates of the goal mouth [0-100]

  • block_coord_x numeric

    The x coordinates of the block [0-100]

  • block_coord_y numeric

    The y coordinates of the block [0-100]

  • block_coord_z numeric

    The z coordinates of the block [0-100]

  • expected_goals numeric

    Expected goals

  • expected_goals_on_target numeric

    Expected goals on target

  • shot_time integer

    Time

  • added_shot_time integer

    Added time because of this incident

  • time_seconds integer

    Time in seconds

  • draw_start_coord_x numeric

    The x coordinates of the start drawing

  • draw_start_coord_y numeric

    The y coordinates of the start drawing

  • draw_block_coord_x numeric

    The x coordinates of the block drawing

  • draw_block_coord_y numeric

    The y coordinates of the block drawing

  • draw_end_coord_x numeric

    The x coordinates of end drawing

  • draw_end_coord_y numeric

    The y coordinates of end drawing

  • draw_goal_coord_x numeric

    The x coordinates of goal drawing

  • draw_goal_coord_y numeric

    The y coordinates of goal drawing

  • incident_type text

    The incident type

Loading...