Connect Apple Health

Overview

You can connect Apple Health to OuterSpatial to bring your workouts into the app as activities. OuterSpatial reads workouts, routes, and optional workout-level metrics. It does not import raw sensor samples. Apple Health import is rolling out gradually, so you may not see it yet.

Connect to Apple Health

1. Open OuterSpatial.
2. Go to the Me tab.
3. Tap the settings icon.
4. Tap Beta Testing.
5. Tap Apple Health.
6. Choose who can see your future activities: Public, Organizations, or Private.
7. Tap Connect Apple Health.
8. When iOS asks, choose which workout, route, energy, heart rate, power, and cadence data OuterSpatial can read.

Apple Health gives OuterSpatial access to the workout history you allowed. After you connect, OuterSpatial works backward through that history and imports supported workouts with routes. Large histories import in smaller groups, and progress is saved if the app closes or an upload must retry. The Apple Health option is available on iPhone; it does not appear on devices without Apple Health.

What Gets Imported

• OuterSpatial reads workouts, workout routes, and the workout-level metrics you allow. These can include active calories, average and maximum heart rate, average and maximum power, cycling cadence, and elevation gain or loss.
• OuterSpatial imports workout totals only. It does not import raw heart-rate, power, cadence, or location samples as separate health records.
• Supported workouts with a recorded route become OuterSpatial activities.
• If Apple Health does not provide enough usable route points, the activity still imports without a route map.
• Workouts already in the history you allowed import as Private, no matter which future-activities choice you make.
• Workouts without a route and workout types OuterSpatial does not support are skipped.
• Workout facts from Apple Health, including time, duration, distance, route, and health metrics, cannot be edited in OuterSpatial.

Review and Personalize an Activity

An activity imported from Apple Health is marked for your review until you confirm it. Open the imported activity and choose one of these actions:

• Tap Add Details to add an optional title, caption, or photo. You can also review places OuterSpatial found along the recorded route, change who can see the activity, and choose whether its route is hidden, generalized, or exact.
• Tap Looks Good to confirm the imported activity without changing it.

Location suggestions come from the recorded route. They can include trails, areas, and outings the route traversed, plus points of interest along the route or near its start and end. Tap Review Locations to compare your exact route and the suggested places on a map. Select a place on the map or in the list, then tap Add or Not This Place. You can optionally say that you were not there, the map is incorrect, or the place is not relevant. OuterSpatial does not ask you to search for unrelated locations.

Your location choices stay in the editor until you tap Save Activity. Confirmed locations add context to the activity and can make it available from those location pages. Saving preserves your add, skip, and remove choices when the route is processed again.

Only you see the review reminder. Reviewing an activity does not change the workout facts supplied by Apple Health, and syncing again does not replace your title, caption, photos, location choices, or visibility choices. Closing the editor without saving does not mark the activity as reviewed or apply location choices. If you have unsaved changes, tap Close and confirm before discarding them; swipe-to-dismiss stays disabled until you save or discard the changes.

Who Can See Your Activities

When you connect, you choose who can see activities imported going forward:

• Public: anyone can see these activities.
• Private: only you can see these activities.
• Organizations: shared with organizations, not with the public.

Your exact routes are never shared by default. Route visibility is controlled separately on each activity.

Check Status and Sync Now

The Apple Health screen is an activity inbox. The card at the top shows the one sync phase that matters now, such as scanning, paused, processing, or needing attention. Tap Details to see upload and processing counts, your last sync, automatic-sync status, connection date, and future-activity visibility. A large history is scanned in smaller groups. You can leave the screen while a scan is active; progress is saved automatically. If the scan pauses, tap Sync Now to continue.

Use the filters to focus on Imported, Importing, Needs Attention, or Not Imported workouts. A workout marked Ready to Sync has not entered the upload queue yet; tap Sync Now to import it. Imported and Needs Attention totals come from your full OuterSpatial account when account status is available. The other filters do not show totals because those workouts can be split between this device and OuterSpatial while syncing. If account status cannot be refreshed, previously known results stay visible with the time they were last confirmed.

The list starts with the newest workouts in the Apple Health history you allowed. Scroll to the bottom to load earlier history automatically. When a filter is active, OuterSpatial continues through earlier history until it finds matching workouts or reaches the end. Each row shows the workout date, duration, distance, and current result. Workouts without routes and unsupported workout types appear under Not Imported. Imported workouts open their activity in OuterSpatial. If an activity imported but Apple Health did not provide enough usable route points, it appears under Imported as Route Unavailable. There is nothing you need to retry for that activity. Activity cards show the route when one is available, workout type, duration, distance, and average pace or speed. When Apple Health supplies additional metrics that you allowed, your own activity cards also show those available totals using your device’s number format. Tap Back to return to Apple Health. Needs Attention is reserved for a problem you can retry while the workout is still in Apple Health. Processing means OuterSpatial is building the activity route and finishes on its own; Sync Now does not restart it.

Pull down on the Apple Health screen to refresh Apple Health, device, and account status without starting an upload. To check for new workouts, resume an interrupted history import, or import older workouts after changing Apple Health from limited history to All Workouts, tap Sync Now in the footer. The footer explains what the action will do and is disabled while you are offline or a sync is already running. Scrolling and loading older list pages do not stop you from starting a sync. After an app update adds support for more Apple Health data, Sync Now may first ask you to review the new read permissions. Sync Now also retries repairable workouts that need attention and repairs locally retained imports that are missing from your OuterSpatial account, regardless of age. Sync and retry results appear briefly and dismiss automatically. Temporary upload failures retry when you sync again or reopen the app.

After the initial history import, Apple Health can notify OuterSpatial about new, changed, or deleted workouts automatically, including while the app is in the background. Delivery timing is controlled by iOS and may not be immediate. OuterSpatial saves its progress after each group, so reopening the app or tapping Sync Now safely catches up after the app was closed, the phone was offline, or background delivery could not finish. Details shows Automatic Sync: On when background delivery is ready. If it shows Manual Only, foreground and Sync Now still work.

If no workouts were found and you expected some, open the Health app, go to Sharing, tap Apps, then OuterSpatial, and check what OuterSpatial can read.

Disconnect Apple Health

1. Go to the Me tab.
2. Tap the settings icon.
3. Tap Beta Testing.
4. Tap Apple Health.
5. Tap Details.
6. Tap Disconnect Apple Health and confirm.

Disconnecting stops automatic delivery and future syncing. Your imported activities stay in OuterSpatial.

Disconnecting does not change the permissions you previously chose in Apple Health. If you reconnect, iOS may not show the permission sheet again. To review or change access, open the Health app, go to Sharing, tap Apps, then OuterSpatial.