# getCurrentWorldMap(completionHandler:) Returns an object encapsulating the world-tracking session’s space-mapping state and set of anchors. ``` func getCurrentWorldMap(completionHandler: @escaping @Sendable (ARWorldMap?, (any Error)?) -> Void) ``` ## Parameters `completionHandler` A closure to be invoked asynchronously after ARKit finishes generating the world map. The closure takes two parameters: - worldMap: The generated [`ARWorldMap`](/documentation/ARKit/ARWorldMap), or `nil` if a map could not be generated. - error: If the `worldMap` is `nil`, an error object describing the failure. ## Discussion An [`ARWorldMap`](/documentation/ARKit/ARWorldMap) encapsulates the state of a running [`ARSession`](/documentation/ARKit/ARSession). This state includes ARKit’s awareness of the physical space the user moves the device in (which ARKit uses to determine the device’s position and orientation), as well as any [`ARAnchor`](/documentation/ARKit/ARAnchor) objects added to the session (which can represent detected real-world features or virtual content placed by your app). After you use this method to save a session’s world map, you can assign it to a configuration’s [`initialWorldMap`](/documentation/ARKit/ARWorldTrackingConfiguration/initialWorldMap) property and use [`run(_:options:)`](/documentation/ARKit/ARSession/run(_:options:)) to start another session with the same spatial awareness and anchors. By saving world maps and using them to start new sessions, your app can add new AR capabilities: - **Multiuser AR experiences.** Create a shared frame of reference by sending archived [`ARWorldMap`](/documentation/ARKit/ARWorldMap) objects to a nearby user’s device. With two devices tracking the same world map, you can build a networked experience where both users can see and interact with the same virtual content. - **Persistent AR experiences.** Save a world map when your app becomes inactive, then restore it the next time your app launches in the same physical environment. You can use anchors from the resumed world map to place the same virtual content at the same positions from the saved session. Before saving a world map, monitor the [`worldMappingStatus`](/documentation/ARKit/ARFrame/worldMappingStatus-swift.property) property to verify that ARKit has an adequate understanding of the user’s environment, ensuring that you can reliably make use of the saved map on a different device or at a later time. World map generation requires a world-tracking AR session. If you call this method on an [`ARSession`](/documentation/ARKit/ARSession) not run with [`ARWorldTrackingConfiguration`](/documentation/ARKit/ARWorldTrackingConfiguration), it invokes your completion handler immediately, providing no world map and an error. > Important: > ARKit calls your `completionHandler` on the session’s ``doc://com.apple.arkit/documentation/ARKit/ARSession/delegateQueue`` (if set; on the main queue otherwise). If you need to perform expensive work from this handler (such as archiving and saving or sending the world map), do so on an appropriate dispatch queue to avoid disrupting performance. --- 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)