# HKWorkoutRoute A sample that contains a workout’s route data. ``` class HKWorkoutRoute ``` ## Overview When creating a workout route, you do not instantiate the [`HKWorkoutRoute`](/documentation/HealthKit/HKWorkoutRoute) objects directly. Instead, create a [`HKWorkoutRouteBuilder`](/documentation/HealthKit/HKWorkoutRouteBuilder) object, and provide it with location data throughout the workout. After the workout ends, call the route builder’s [`finishRoute(with:metadata:completion:)`](/documentation/HealthKit/HKWorkoutRouteBuilder/finishRoute(with:metadata:completion:)) method to create the route. For detailed instructions, see . The route’s location data is stored as an array of objects. Because the route may contain a large number of location objects, use a [`HKWorkoutRouteQuery`](/documentation/HealthKit/HKWorkoutRouteQuery) object to asynchronously read the location data from the HealthKit store in batches. For more information, see . ### Using workout routes As with many HealthKit classes, don’t subclass the [`HKWorkoutRoute`](/documentation/HealthKit/HKWorkoutRoute) class. You can extend [`HKWorkoutRoute`](/documentation/HealthKit/HKWorkoutRoute) objects by adding custom metadata keys and values to the metadata dictionary when the object is created. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)