<!-- Markdown mirror of https://pinflag.io/technology/apple-native-maps — the canonical page is the HTML URL. -->

# Apple-Native Course Mapping

> Canonical: https://pinflag.io/technology/apple-native-maps


On iOS the course map is a native Apple MKMapView rendered behind the interface — unconditionally, not behind a flag. That buys deep zoom, overlays glued to the map by MapKit itself, instant re-entry from a warm map, and a camera that frames every hole the same way.


*The PinFlag iOS app is in pre-release. Leave your email and we’ll tell you the moment it’s available.*


On iOS the course map is a real MKMapView rendered natively behind the interface — unconditionally, not behind a flag. That buys deep zoom (about 5 meters, far past web tile limits), overlays glued to the map by MapKit itself, instant course re-entry from a warm native map, and a one-thumb portrait interaction model with a deterministic, set-once camera.


## Why it matters

- Web maps jitter, cap their zoom, and reload; a native map does none of that.
- A deterministic camera means the hole you rehearsed is framed like the hole you play.


## How it works

1. **Native under the shell** — The satellite map is a real MKMapView behind a transparent layer; touches pass through to it except over controls.
2. **Overlays in the map’s own layer tree** — Markers and aim lines are native annotations and layers, recomputed in the compositing pass — no lag, no shake.
3. **One warm map** — The map instance persists; re-entering a course re-aims it instantly, and course data loads with no network.


## Everything Apple-Native Course Mapping does

- Native MKMapView satellite rendering — the default and only on-course map on iOS
- Deep zoom to ~5 m — beyond typical web-map floors
- Zero-shake overlays: annotations and aim layers live in the map’s own layer tree
- Instant course re-entry — one warm map, re-aimed
- Deterministic set-once camera computed purely from verified tee and green
- Satellite or Enhanced imagery — a presentation-only grade that never changes a distance
- One-thumb portrait gestures; offline course data with honest imagery requirements

## Who it’s for

Players who notice the difference between a map that moves like the Maps app and one that moves like a website.


## What’s different

- Deep zoom to roughly 5 meters — beyond typical web-map floors.
- Two imagery looks — Satellite and an Enhanced grade — that never change a distance.
- Honest offline story: course data is cached; Apple’s imagery streams and requires a connection.

## Frequently asked questions

### Is the map really native, or a web map styled to look native?

Really native: an Apple MKMapView renders the imagery and owns the gestures; the interface draws above it. On iOS this is the only on-course map — there is no flag and no web fallback in play.

### Does the map work offline?

Your course data is cached and works offline; the satellite imagery itself streams from Apple and needs a connection — the app says so rather than pretending.
