How to Add Maps and Location to an iPhone App (2026)
Add maps and location to an iPhone app without code or map keys: Apple Maps pins, your position, distances, directions and the permission rules.

By Sigsten Gustavii· · 8 min read
To add maps to an iPhone app, decide what the map shows (your own places, the person's position, or both), use Apple's MapKit to draw it, ask for location only when a feature needs it with a clear reason, handle a "no" gracefully, and hand turn-by-turn directions to Apple Maps. With Borel, you describe the map and it writes the Swift.
| Feature | Apple tool | Needs location permission? | Example |
|---|---|---|---|
| Show a map with pins | MapKit | No | Every café on a list |
| Show where I am | Core Location and MapKit | Yes, while in use | "You are here" on a trail map |
| How far away is it | Core Location | Yes, while in use | "1.2 km away" under each shop |
| Sort by nearest | Core Location | Yes, while in use | The nearest playground at the top |
| Directions | Opens Apple Maps | No | Directions to a viewing |
| Save a spot | Core Location | Yes, while in use | Where I parked |
Maps are one of the clearest reasons to make a native app rather than a website. MapKit is the same map as Apple Maps, it scrolls and zooms the way iPhone owners expect, and it comes with the phone. There is no account with a map company and no bill per map load.
Apple Maps or Google Maps?
| Apple MapKit | An outside map SDK | |
|---|---|---|
| Account and key | None | An account and an API key to protect |
| Cost | No per-load bill for apps | Usage pricing past a free allowance |
| Look | Matches Apple Maps and iOS | The provider's own style |
| Directions | Hand off to Apple Maps | Depends on the SDK |
| In a Borel app | Built in | Not used |
For most apps, MapKit is the obvious choice on iPhone. Outside map services earn their place when you need a feature only they offer, and then you also take on a key and a bill; see the Google Maps Platform pricing for how theirs works.
What you can build with a map
- Your places as pins: shops, stops, trails, venues or homes for sale, each pin opening a detail card.
- The person's own places: where they parked, favourite cafés, every stop of a trip.
- Shared places: a club's meeting points or a marketplace's listings, kept in the app's database and visible to everyone signed in.
- Nearest at the top: a list under the map sorted by distance from the person.
- Directions: one tap opens Apple Maps with the route.
Ideas to borrow from Borel's maps and location page: a parking spot saver, a favourite places list, a trip map, a run club map.
Map ideas by kind of app
| App | What the map shows | Location needed? |
|---|---|---|
| Shop or café chain | Every branch, with hours and directions | Only for Near me |
| Club or community | This week's meeting point | No |
| Travel guide | Sights, food and stays for a city | Optional, for distances |
| Marketplace | Listings near the buyer | Yes, while browsing nearby |
| Personal places | Favourite spots, where I parked | Yes, to save the current spot |
| Events | The venue and nearby hotels | No |
Location permission, done right
Before an app reads the phone's position, iOS asks the person with a sentence the app provides. Apple's Guideline 5.1.1(ii) asks for a sentence that clearly describes the use, 5.1.1(iii) asks apps to request only what they need, and 5.1.5 says location should be used only when it is directly relevant to the app's features.
| Choice | What it allows | In a Borel app |
|---|---|---|
| While using the app | Position only while the app is open | What Borel builds |
| Always | Position in the background too | Not used: Borel apps don't track in the background |
| Precise or approximate | The person can share a rough area only | The app works with either |
| Don't allow | No position | The app explains and offers a button to Settings |
Three habits make people say yes. Ask at the moment a feature needs it, such as tapping "Near me", not when the app opens. Write the reason in plain words, like "Show cafés near you and how far away they are." And keep the app useful without it: a map of your places works with no permission at all.
Privacy: when not to show an exact spot
Location is personal. A few rules protect the people using your app:
- Never show someone's exact position to others unless that is the whole point and they turned it on.
- Round distances in apps where people meet strangers: "about 3 km" instead of "2.83 km".
- Store an area, not a point, when a rough place is enough.
- Show a street, not a door, for homes, until there is a reason to share the address.
The dating app guide goes deeper on location privacy between strangers.
What Borel won't do for you
- Background tracking: recording a route while the phone is locked, or geofences that fire when someone arrives. Borel builds location for while the app is in use.
- Live tracking of other people: a moving dot for a courier or a friend.
- In-app turn-by-turn navigation: Borel apps hand directions to Apple Maps instead.
- Custom map tiles or offline map downloads.
These are real limits for running trackers and delivery platforms; for store finders, trip maps, club maps and listings, they rarely matter.
Testing maps and location
In Borel's iOS Simulator in your browser, the map works and pins show, so you can test everything that doesn't depend on where you are. The simulator's position is a simulated one, not yours. To check the real permission prompt and your actual position, install the app on your iPhone with Borel Companion, which comes with Pro. Test saying no as well as yes.
Apple's rules for location
| Guideline | What Apple asks | In a Borel app |
|---|---|---|
| 5.1.5 Location services | Use location only when directly relevant | Asked when a location feature is used |
| 5.1.1(ii) Permission | A clear purpose sentence | Borel writes one for your app |
| 5.1.1(iii) Data minimisation | Only the data the feature needs | While in use only, never always |
| 5.1.1(i) Privacy policy | Say what you collect, including location | Borel hosts a policy for the app |
Read the full rules on Apple's App Review Guidelines page.
How to choose the right way to add maps
- Borel, if you want Apple Maps, pins, position, distances and directions in a native iPhone app from a description, with no key.
- MapKit by hand in Xcode, if you are a Swift developer and need background location, geofences or custom overlays.
- An outside map SDK, if you need a feature MapKit lacks and accept a key and usage pricing.
- [CatDoes](/compare/catdoes) or [a0](/compare/a0), if you build React Native apps for both stores.
How to do it with Borel, step by step
Step 1: Describe what the map shows
Add a Map tab to my café guide. Show every café in the list as a pin; tapping a pin opens a card with the photo, opening hours and a Directions button that opens Apple Maps. Add a Near me button that asks for location and sorts the list under the map by distance, showing how far each café is. If I say no to location, keep the map and list working and show a short note with a button to Settings.Rivet writes the map with MapKit and the position with Core Location, adds the permission sentence, and handles a no.
Step 2: Try it in the simulator
Open the Map tab on the live iPhone in your browser, tap pins, press Near me and check the distances.
Step 3: Try it outside
Install the app on your iPhone with Companion (Pro) and walk around the block. Ask for changes in plain words: "zoom to fit all pins", "colour pins by category".
Step 4: Publish
Stamp checks that every permission has a clear reason, and Publish builds and uploads the app under your Apple Developer account. Read more about MapKit in the glossary.
The Bottom Line
On iPhone, Apple's MapKit gives you a real map with no key and no bill, and Core Location adds the person's position when they allow it. Borel writes both natively from a sentence, asks for location only while the app is in use, and keeps working when someone says no. Open your app in Borel, describe your map, and try it on a live iPhone.
Questions people ask
Do I need a Google Maps API key for an iPhone app?
No. iPhone apps can use Apple's MapKit, which needs no key or account. Borel apps use MapKit.
Is Apple MapKit free?
Apps don't pay per map load for MapKit, unlike many outside map services. You only need Apple's Developer Program to publish the app.
How do I ask for location permission?
iOS shows the prompt with a sentence your app provides. Ask when a feature needs it and explain why in plain words. Borel writes the sentence for your app.
Can my app track location in the background?
Not a Borel app: it uses location only while the app is in use. Background tracking and geofences need code written by hand in Xcode.
Can the app give turn-by-turn directions?
It opens Apple Maps with the route, which gives full turn-by-turn navigation. In-app navigation is not something Borel builds.
Can I test location without an iPhone?
Mostly. The iOS Simulator in your browser shows the map and pins, and its position is a simulated one. The real prompt and your own position need an iPhone.
What if someone says no to location?
A Borel app keeps the map and lists working, explains what is off, and offers a button to Settings so they can change their mind.
Does a map work without internet?
Map tiles need a connection to load, but the list of your places can be kept on the phone so names, notes and addresses still show offline.
Can pins have different colours or icons?
Yes. Ask for pins coloured or marked by category, such as cafés in brown and parks in green, and a legend if there are several kinds.
Can several people share places on one map?
Yes. Shared places live in the app's database in Borel Cloud, so everyone signed in sees the same pins, and only the person who added a place can change it.
Apple Maps gives every iPhone app a real map with no key and no bill, and I think more apps should use it. Describe your map and try it on a walk.
– Sigsten
Make your iPhone app in Borel
Describe the app you want and see its first screens before you pay anything.
See your app free