How GolfStory Maps the World — and Why Your Round Matters
The Yardage on Your Screen Started Somewhere
Every time you glance at your watch on the tee and see "168 yards to the middle," something invisible just happened. Your GPS chip checked your position against a map of that hole — a map that someone, somewhere, had to build. The number on your wrist is the end of a long pipeline.
This is a post about that pipeline. About what we have, what's missing, and how every round you play helps fix it.
Where the Data Starts
GolfStory's course library covers tens of thousands of courses worldwide. The base layer of that data — coordinates for tees, greens, hazards — comes from established providers and from our own surveying work. It's the starting point.
But "we have data" is not the same as "the data is good." Some courses are fully mapped: every tee, every green, every bunker, every yardage marker accounted for. Some courses have only the basics. A small but stubborn minority are barely there at all — a name on a list and not much else.
That's the honest picture. Most courses are in good shape. A meaningful minority are not. And the difference between the two is where we spend most of our time.
Layer Two: Maps From the Sky
Coordinates tell you where the green is. They don't tell you the shape of the green, the boundaries of the fairway, the curve of the dogleg, or where the bunkers actually sit. For that you need a map.
We build those maps using high-resolution satellite imagery. Modern computer-vision techniques can pick out greens, fairways, sand, and water from a good aerial photo with remarkable accuracy. Combined with course-specific knowledge — par, hole layout, typical tee position — the resulting polygons are good enough to power the precise distances you see during play.
It works well, but not perfectly. Shadows, time of day, tree cover, and seasonal grass colour all change what a satellite sees. So every map we generate passes through a human review step before it ships. Real eyes, real corrections.
Layer Three: Your Rounds
This is where you come in. The third — and most important — layer of course data improves only when real golfers play real rounds.
GPS tracks show us where golfers actually walk. Over enough rounds, walking patterns reveal the real fairway, the real cart path, the real teeing ground. A map drawn from a satellite gets validated, or corrected, by what the body of evidence on the ground tells us.
Pin gestures record where the pin was on a given day. When you pick the ball out of the hole, the watch recognises the motion and stamps a coordinate. Stack enough of these per hole and we learn not just where the green is, but where the pin tends to live.
Stroke positions from detected shots tell us where the playable area really is. A shot landing well outside the fairway we drew is a hint that our outline was off.
User reports close the loop directly. If something looks wrong on the map, tell us. Those reports go into a review queue that a human looks at.
Together, these signals mean every course in GolfStory gets better the more it's played. The 50th round on a course refines the data more than the first 49.
The Partnership Ask
Here's the part we want to be honest about: course data is too big a problem for any one team to solve alone. We work with data providers. We use satellite imagery. We review the output by hand. We refresh entire countries, region by region, on a rolling schedule.
But the most valuable signal — by far — is golfers playing rounds and trusting us with the data. Every round you record makes your home course more accurate for the next golfer who plays it. Every pin you walk to plants a flag in our database. Every misplaced fairway boundary you report gets fixed.
If you play 30 rounds at your home course this season, you'll have made it measurably better by autumn. Not someday, in the abstract — measurably, in the polygons themselves.
What's Next
A few things on the roadmap:
Rolling country refreshes. We work through the map country by country, refreshing the underlying data and applying improvements from recent rounds.
Automatic pin position averaging. Once we have enough pin-gesture detections per hole, we'll surface "common pin positions" so you can see the typical front/back/left/right pattern before you tee off.
Community course corrections. A first-pass UI where players can drag a misplaced green outline or move a bunker. Reviewed by us before it ships — with you in the loop.
Course quality indicators. So when you pick a course, you know up front whether it's fully mapped, partially mapped, or still being built up.
Play It, Improve It
Course data is the kind of thing that's never done. There's no version 1.0 launch. There's only "more rounds played, more outlines fixed, more pins logged."
The best thing you can do is play. Bring the watch. Trust the GPS. Tell us when something's wrong. The map under your feet will get better — round by round, course by course, country by country — because of it.