OpenPinsheet

Open pin positions for golf courses.

The cup moves. OpenPinsheet keeps a record of where it stood, by date and hole, and anyone may use it under the Open Database License.

Get the dataAdd your club

No day published yet

114 · 6L222 · 4R39 · 7R427 · 5L518 · 3R611 · 8L724 · 6R816 · 4L920 · 5R
A pin sheet is the day's chart of hole locations. This example has made-up positions: metres from the front edge, then from the nearer side.

One record, one fact

On this date, on this hole, the cup was here.

A record carries no names, no time of day and no IDs; the coordinate locates itself. It also says how the position was found: estimated in metres or yards from the edges of the green, surveyed with GNSS, placed on a map, or detected by a camera.

Read the format

Who it is for

Greenkeepers and superintendents

Where the cup has been on each green across a season, kept even when the club changes tools.

Developers

One format for every course, as CSV and GeoJSON. No account and no key.

Researchers

How greens are used over days and seasons, with the source of every position stated.

Add your club

Clubs do not upload anything here. Your greenkeeper enters the day's pins in a tool the club already uses, and that tool, a data partner, passes them on.

  1. The greenkeeper enters the pinsMetres or yards from the front and from the side, in the partner's tool.
  2. The data partner passes on the dayOnce the day is over everywhere, without names or times.
  3. The day is publishedThree days later, as a file that does not change.

Data partners

OpenYardageopenyardage.comYardage books for golf courses, drawn from OpenStreetMap and free for golfers. Clubs enter the day's pins in the club dashboard, and OpenYardage passes them on.

You run a golf app or a course tool? Become a data partner and deliver pins directly.

Get the data

One CSV and one GeoJSON file per day, published three days after that day, plus one file per year and an index with checksums. A published day file never changes.

Apps get today's pins through the live API, from about seven in the morning local time.

Nothing published yet. Files appear here three days after the first day a club enters pins.

Index of all files: https://data.openpinsheet.com/v1/index.json. Code examples and caching: Use the files.

Found a wrong position? Write to info@openyardage.com with the date, the course and the hole.

How to credit

Use the data for anything, including commercially. If you build a database from it, name the source and share that database under the same licence.

Pin positions: OpenPinsheet and its channels, Open Database License 1.0. Estimated positions are computed against green outlines from OpenStreetMap: map data © OpenStreetMap contributors (ODbL).

Supported by

OpenYardageopenyardage.comPays the costs of running OpenPinsheet, including the domain.

OpenPinsheet costs little to run. Supporters pay for it; the data and its licence stay open.