Venue

Data Dictionary for Venue

The following example shows how the Golf venue data is identified. The data tables below will identify the properties available within the metadata.

{
  "id": 4193,
  "name": "Augusta National Golf Club",
  "type": "Golf course",
  "country": {
    "id": 16,
    "name": "USA"
  },
  "sports": [
    {
      "id": 3,
      "name": "Golf"
    }
  ],
  "meta": {
    "city": {
      "code": "venue:city",
      "name": "City",
      "value": "Augusta"
    },
    "latitude": {
      "code": "venue:latitude",
      "name": "Latitude",
      "value": "33.501707"
    },
    "longitude": {
      "code": "venue:longitude",
      "name": "Longitude",
      "value": "-82.022971"
    },
    "length1": {
      "code": "venue:length1",
      "name": "Length1",
      "value": "407"
    },
    "length2": {
      "code": "venue:length2",
      "name": "Length2",
      "value": "526"
    },
    "par1": {
      "code": "venue:par1",
      "name": "Par1",
      "value": "4"
    },
    "par2": {
      "code": "venue:par2",
      "name": "Par2",
      "value": "5"
    }
  },
  "updated": "2013-05-06T13:58:03Z",
  "links": [
    {
      "rel": "self",
      "href": "http://sport.api.press.net/v1/venue/4193"
    }
  ]
}
<?xml version="1.0" encoding="utf-8" ?>
<pa:sports-content xmlns="http://iptc.org/std/nar/2006-10-01/" xmlns:pa="http://sport-api.pa.press.net/2016-09-30/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <pa:sports-metadata doc-id="http://sport.api.press.net/v1/venue/4193" document-class="pa:venue-detail">
        <sports-title>Augusta National Golf Club</sports-title>
    </pa:sports-metadata>
    <pa:site id="venue.4193">
        <site-metadata>
            <name>Augusta National Golf Club</name>
            <sports-property formal-name="venue:city" value="Augusta"/>
            <sports-property formal-name="venue:latitude" value="33.501707"/>
            <sports-property formal-name="venue:longitude" value="-82.022971"/>
            <sports-property formal-name="venue:length1" value="407"/>
            <sports-property formal-name="venue:length2" value="526"/>
            <sports-property formal-name="venue:par1" value="4"/>
            <sports-property formal-name="venue:par2" value="5"/>
            <sports-property formal-name="common:updated" value="2013-05-06T13:58:03Z"/>
            <sports-content-codes>
                <sports-content-code code-type="pa:country" code-key="country:16" code-name="USA"/>
                <sports-content-code code-type="pa:sport" code-key="sport:3" code-name="Golf"/>
            </sports-content-codes>
        </site-metadata>
    </pa:site>
</pa:sports-content>

Property Location

Content Type

Path

JSON

$.meta

XML

/:sports-content/:site/*:site-metadata

Property

Code

Example

Unit

city

venue:city

Aberdeen

String

latitude

venue:latitude

-18.118205

Number

length

venue:length

6531*

Number

length-{n}*

venue:length-1

156

Number

longitude

venue:longitude

-0.050693

Number

par

venue:par

70*

Number

par-{n}*

venue:par-1

3*

Number

*{n} = hole number, for example; {n} par-1 is the par value for hole one

Multiple courses

The course that an individual Participant is playing on is presented in the Event Composition endpoint.

Where an event is played across multiple courses, the relevant courses are available with course details at the Stage level. Within the Event Composition, for round detail per Participant, the course played is identified:

"id": 845644,
  "name": "CareerBuilder Challenge",
  "gender": "male",
  "start": "2017-01-19",
  "end": "2017-01-22",
  "country": {
    "id": 16,
    "name": "USA"
  },
  "season": {
    "id": 10683,
    "name": "2017"
  },
  "tournament": {
    "id": 431,
    "name": "PGA Tour",
    "gender": "male"
  },
  "sport": {
    "id": 3,
    "name": "Golf"
  },
  "meta": {
    "currency": {
      "code": "stage:currency",
      "name": "Currency",
      "value": "US Dollar"
    },
    "cut": {
      "code": "stage:cut",
      "name": "Cut",
      "value": "211"
    },
    "length": {
      "code": "stage:length",
      "name": "Length",
      "value": "6675"
    },
    "par": {
      "code": "stage:par",
      "name": "Par",
      "value": "72"
    },
    "prize": {
      "code": "stage:prize",
      "name": "Prize",
      "value": "5800000"
    },
    "projected-cut": {
      "code": "stage:projected-cut",
      "name": "Projected Cut",
      "value": "77"
    },
    "rounds": {
      "code": "stage:rounds",
      "name": "Rounds",
      "value": "4"
    },
    "tee-time-round-1": {
      "code": "stage:tee-time-round-1",
      "name": "Tee Time Round 1",
      "value": "2017-01-19T16:30:00Z"
    },
    "tee-time-round-2": {
      "code": "stage:tee-time-round-2",
      "name": "Tee Time Round 2",
      "value": "2017-01-20T15:30:00Z"
    },
    "tee-time-round-3": {
      "code": "stage:tee-time-round-3",
      "name": "Tee Time Round 3",
      "value": "2017-01-21T16:30:00Z"
    },
    "tee-time-round-4": {
      "code": "stage:tee-time-round-4",
      "name": "Tee Time Round 4",
      "value": "2017-01-22T15:30:00Z"
    },
    "type": {
      "code": "stage:type",
      "name": "Type",
      "value": "Stroke Play"
    },
    "venue": {
      "code": "stage:venue",
      "name": "Venue",
      "value": "PGA West TPC Stadium Course"
    }
  },
  "venues": [
    {
      "id": 4292,
      "name": "La Quinta G and CC",
      "type": "Golf course",
      "country": {
        "id": 16,
        "name": "USA"
      },
      "meta": {
        "city": {
          "code": "venue:city",
          "name": "City",
          "value": "La Quinta"
        },
        "latitude": {
          "code": "venue:latitude",
          "name": "Latitude",
          "value": "33.6753"
        },
        "longitude": {
          "code": "venue:longitude",
          "name": "Longitude",
          "value": "-116.2975"
        },
        "length1": {
          "code": "venue:length1",
          "name": "Length1",
          "value": "349"
        },
        "length2": {
          "code": "venue:length2",
          "name": "Length2",
          "value": "397"
        },
        "length3": {
          "code": "venue:length3",
          "name": "Length3",
          "value": "185"
        },
        "length4": {
          "code": "venue:length4",
          "name": "Length4",
          "value": "351"
        },
        "length5": {
          "code": "venue:length5",
          "name": "Length5",
          "value": "472"
        },
        "length6": {
          "code": "venue:length6",
          "name": "Length6",
          "value": "482"
        },
        "length7": {
          "code": "venue:length7",
          "name": "Length7",
          "value": "154"
        },
        "length8": {
          "code": "venue:length8",
          "name": "Length8",
          "value": "356"
        },
        "length9": {
          "code": "venue:length9",
          "name": "Length9",
          "value": "365"
        },
        "length10": {
          "code": "venue:length10",
          "name": "Length10",
          "value": "370"
        },
        "length11": {
          "code": "venue:length11",
          "name": "Length11",
          "value": "497"
        },
        "length12": {
          "code": "venue:length12",
          "name": "Length12",
          "value": "185"
        },
        "length13": {
          "code": "venue:length13",
          "name": "Length13",
          "value": "500"
        },
        "length14": {
          "code": "venue:length14",
          "name": "Length14",
          "value": "429"
        },
        "length15": {
          "code": "venue:length15",
          "name": "Length15",
          "value": "188"
        },
        "length16": {
          "code": "venue:length16",
          "name": "Length16",
          "value": "415"
        },
        "length17": {
          "code": "venue:length17",
          "name": "Length17",
          "value": "385"
        },
        "length18": {
          "code": "venue:length18",
          "name": "Length18",
          "value": "377"
        },
        "par1": {
          "code": "venue:par1",
          "name": "Par1",
          "value": "4"
        },
        "par2": {
          "code": "venue:par2",
          "name": "Par2",
          "value": "4"
        },
        "par3": {
          "code": "venue:par3",
          "name": "Par3",
          "value": "3"
        },
        "par4": {
          "code": "venue:par4",
          "name": "Par4",
          "value": "4"
        },
        "par5": {
          "code": "venue:par5",
          "name": "Par5",
          "value": "5"
        },
        "par6": {
          "code": "venue:par6",
          "name": "Par6",
          "value": "5"
        },
        "par7": {
          "code": "venue:par7",
          "name": "Par7",
          "value": "3"
        },
        "par8": {
          "code": "venue:par8",
          "name": "Par8",
          "value": "4"
        },
        "par9": {
          "code": "venue:par9",
          "name": "Par9",
          "value": "4"
        },
        "par10": {
          "code": "venue:par10",
          "name": "Par10",
          "value": "4"
        },
        "par11": {
          "code": "venue:par11",
          "name": "Par11",
          "value": "5"
        },
        "par12": {
          "code": "venue:par12",
          "name": "Par12",
          "value": "3"
        },
        "par13": {
          "code": "venue:par13",
          "name": "Par13",
          "value": "5"
        },
        "par14": {
          "code": "venue:par14",
          "name": "Par14",
          "value": "4"
        },
        "par15": {
          "code": "venue:par15",
          "name": "Par15",
          "value": "3"
        },
        "par16": {
          "code": "venue:par16",
          "name": "Par16",
          "value": "4"
        },
        "par17": {
          "code": "venue:par17",
          "name": "Par17",
          "value": "4"
        },
        "par18": {
          "code": "venue:par18",
          "name": "Par18",
          "value": "4"
        }
      }
    },
    {
      "id": 7779,
      "name": "Nicklaus GC at LionsGate",
      "type": "Golf course",
      "country": {
        "id": 16,
        "name": "USA"
      },
      "meta": {
        "city": {
          "code": "venue:city",
          "name": "City",
          "value": "Overland Park"
        },
        "length1": {
          "code": "venue:length1",
          "name": "Length1",
          "value": "342"
        },
        "length2": {
          "code": "venue:length2",
          "name": "Length2",
          "value": "379"
        },
        "length3": {
          "code": "venue:length3",
          "name": "Length3",
          "value": "162"
        },
        "length4": {
          "code": "venue:length4",
          "name": "Length4",
          "value": "492"
        },
        "length5": {
          "code": "venue:length5",
          "name": "Length5",
          "value": "405"
        },
        "length6": {
          "code": "venue:length6",
          "name": "Length6",
          "value": "371"
        },
        "length7": {
          "code": "venue:length7",
          "name": "Length7",
          "value": "128"
        },
        "length8": {
          "code": "venue:length8",
          "name": "Length8",
          "value": "465"
        },
        "length9": {
          "code": "venue:length9",
          "name": "Length9",
          "value": "375"
        },
        "length10": {
          "code": "venue:length10",
          "name": "Length10",
          "value": "377"
        },
        "length11": {
          "code": "venue:length11",
          "name": "Length11",
          "value": "175"
        },
        "length12": {
          "code": "venue:length12",
          "name": "Length12",
          "value": "369"
        },
        "length13": {
          "code": "venue:length13",
          "name": "Length13",
          "value": "482"
        },
        "length14": {
          "code": "venue:length14",
          "name": "Length14",
          "value": "342"
        },
        "length15": {
          "code": "venue:length15",
          "name": "Length15",
          "value": "380"
        },
        "length16": {
          "code": "venue:length16",
          "name": "Length16",
          "value": "484"
        },
        "length17": {
          "code": "venue:length17",
          "name": "Length17",
          "value": "186"
        },
        "length18": {
          "code": "venue:length18",
          "name": "Length18",
          "value": "416"
        },
        "par1": {
          "code": "venue:par1",
          "name": "Par1",
          "value": "4"
        },
        "par2": {
          "code": "venue:par2",
          "name": "Par2",
          "value": "4"
        },
        "par3": {
          "code": "venue:par3",
          "name": "Par3",
          "value": "3"
        },
        "par4": {
          "code": "venue:par4",
          "name": "Par4",
          "value": "5"
        },
        "par5": {
          "code": "venue:par5",
          "name": "Par5",
          "value": "4"
        },
        "par6": {
          "code": "venue:par6",
          "name": "Par6",
          "value": "4"
        },
        "par7": {
          "code": "venue:par7",
          "name": "Par7",
          "value": "3"
        },
        "par8": {
          "code": "venue:par8",
          "name": "Par8",
          "value": "5"
        },
        "par9": {
          "code": "venue:par9",
          "name": "Par9",
          "value": "4"
        },
        "par10": {
          "code": "venue:par10",
          "name": "Par10",
          "value": "4"
        },
        "par11": {
          "code": "venue:par11",
          "name": "Par11",
          "value": "3"
        },
        "par12": {
          "code": "venue:par12",
          "name": "Par12",
          "value": "4"
        },
        "par13": {
          "code": "venue:par13",
          "name": "Par13",
          "value": "5"
        },
        "par14": {
          "code": "venue:par14",
          "name": "Par14",
          "value": "4"
        },
        "par15": {
          "code": "venue:par15",
          "name": "Par15",
          "value": "4"
        },
        "par16": {
          "code": "venue:par16",
          "name": "Par16",
          "value": "5"
        },
        "par17": {
          "code": "venue:par17",
          "name": "Par17",
          "value": "3"
        },
        "par18": {
          "code": "venue:par18",
          "name": "Par18",
          "value": "4"
        }
      }
    },
    {
      "id": 6356,
      "name": "PGA West TPC Stadium Course",
      "type": "Golf course",
      "country": {
        "id": 16,
        "name": "USA"
      },
      "meta": {
        "city": {
          "code": "venue:city",
          "name": "City",
          "value": "La Quinta"
        },
        "latitude": {
          "code": "venue:latitude",
          "name": "Latitude",
          "value": "33.639396"
        },
        "longitude": {
          "code": "venue:longitude",
          "name": "Longitude",
          "value": "-116.262471"
        },
        "length1": {
          "code": "venue:length1",
          "name": "Length1",
          "value": "407"
        },
        "length2": {
          "code": "venue:length2",
          "name": "Length2",
          "value": "339"
        },
        "length3": {
          "code": "venue:length3",
          "name": "Length3",
          "value": "431"
        },
        "length4": {
          "code": "venue:length4",
          "name": "Length4",
          "value": "176"
        },
        "length5": {
          "code": "venue:length5",
          "name": "Length5",
          "value": "489"
        },
        "length6": {
          "code": "venue:length6",
          "name": "Length6",
          "value": "233"
        },
        "length7": {
          "code": "venue:length7",
          "name": "Length7",
          "value": "316"
        },
        "length8": {
          "code": "venue:length8",
          "name": "Length8",
          "value": "511"
        },
        "length9": {
          "code": "venue:length9",
          "name": "Length9",
          "value": "413"
        },
        "length10": {
          "code": "venue:length10",
          "name": "Length10",
          "value": "380"
        },
        "length11": {
          "code": "venue:length11",
          "name": "Length11",
          "value": "564"
        },
        "length12": {
          "code": "venue:length12",
          "name": "Length12",
          "value": "332"
        },
        "length13": {
          "code": "venue:length13",
          "name": "Length13",
          "value": "196"
        },
        "length14": {
          "code": "venue:length14",
          "name": "Length14",
          "value": "356"
        },
        "length15": {
          "code": "venue:length15",
          "name": "Length15",
          "value": "423"
        },
        "length16": {
          "code": "venue:length16",
          "name": "Length16",
          "value": "549"
        },
        "length17": {
          "code": "venue:length17",
          "name": "Length17",
          "value": "154"
        },
        "length18": {
          "code": "venue:length18",
          "name": "Length18",
          "value": "401"
        },
        "par1": {
          "code": "venue:par1",
          "name": "Par1",
          "value": "4"
        },
        "par2": {
          "code": "venue:par2",
          "name": "Par2",
          "value": "4"
        },
        "par3": {
          "code": "venue:par3",
          "name": "Par3",
          "value": "4"
        },
        "par4": {
          "code": "venue:par4",
          "name": "Par4",
          "value": "3"
        },
        "par5": {
          "code": "venue:par5",
          "name": "Par5",
          "value": "5"
        },
        "par6": {
          "code": "venue:par6",
          "name": "Par6",
          "value": "3"
        },
        "par7": {
          "code": "venue:par7",
          "name": "Par7",
          "value": "4"
        },
        "par8": {
          "code": "venue:par8",
          "name": "Par8",
          "value": "5"
        },
        "par9": {
          "code": "venue:par9",
          "name": "Par9",
          "value": "4"
        },
        "par10": {
          "code": "venue:par10",
          "name": "Par10",
          "value": "4"
        },
        "par11": {
          "code": "venue:par11",
          "name": "Par11",
          "value": "5"
        },
        "par12": {
          "code": "venue:par12",
          "name": "Par12",
          "value": "4"
        },
        "par13": {
          "code": "venue:par13",
          "name": "Par13",
          "value": "3"
        },
        "par14": {
          "code": "venue:par14",
          "name": "Par14",
          "value": "4"
        },
        "par15": {
          "code": "venue:par15",
          "name": "Par15",
          "value": "4"
        },
        "par16": {
          "code": "venue:par16",
          "name": "Par16",
          "value": "5"
        },
        "par17": {
          "code": "venue:par17",
          "name": "Par17",
          "value": "3"
        },
        "par18": {
          "code": "venue:par18",
          "name": "Par18",
          "value": "4"
        }

What’s Next