<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "macCatalyst: -",
    "macOS: 14.0.0 -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "MapKit",
  "identifier" : "/documentation/MapKit/LookAroundPreview",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "MapKit",
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:15_MapKit_SwiftUI17LookAroundPreviewV"
  },
  "title" : "LookAroundPreview"
}
-->

# LookAroundPreview

A view that provides a Look Around preview for a specific geographic location.

```
@MainActor @preconcurrency struct LookAroundPreview
```

## Overview

Use a `LookAroundPreview` to create preview imagery for a specific geographic location on the map that you can place in your view. In the following example, a travel recommendations app displays and styles a stack of Look Around previews it generates from an array of `ItineraryItem` structures that contain the location’s title and Look Around scene:

```swift
    struct LookAroundPreviewsView: View {
        let itinerary: [ItineraryItem]
        var body: some View {
            ScrollView {
                LazyVStack {
                    ForEach(itinerary) { item in
                        LookAroundPreview(initialScene: item.lookAroundScene)
                            .frame(height: 128)
                            .overlay(alignment: .bottomTrailing) {
                                Text(item.title)
                                    .font(.caption)
                                    .foregroundColor(.white)
                                    .padding()
                            }
                    }
                }
            }
        }
    }
```

To display a Look Around viewer a person can explore, apply a `lookAroundViewer` view modifier to a specific view, then add a control the user interacts with to display the Look Around viewer. In the following example, the `lookAroundViewer` view modifier observes a binding to Boolean value to determine whether to display the Look Around viewer.

```swift
    var lookAroundScene: MKLookAroundScene?

    @State private var isLookingAround: Bool = false

    var body: some View {
        MyInterestingView()
            .lookAroundViewer(isPresented: $isLookingAround, initialScene: lookAroundScene)
            .toolbar {
                ToolbarItem {
                    Button(action: { lookingAround = true }) {
                        Image(systemName: "binoculars")
                }
            }
        }   
    }
```

## Topics

### Creating a Look Around preview

[`init(initialScene:allowsNavigation:showsRoadLabels:pointsOfInterest:badgePosition:)`](/documentation/MapKit/LookAroundPreview/init(initialScene:allowsNavigation:showsRoadLabels:pointsOfInterest:badgePosition:))

Creates a Look Around preview with an initial scene, navigation, road label, points of interest, and badge position you specify.

[`init(scene:allowsNavigation:showsRoadLabels:pointsOfInterest:badgePosition:)`](/documentation/MapKit/LookAroundPreview/init(scene:allowsNavigation:showsRoadLabels:pointsOfInterest:badgePosition:))

Creates a Look Around preview with a binding to a scene, navigation, road label, points of interest, and badge position you specify.

### Creating a Look Around viewer

  <doc://com.apple.documentation/documentation/SwiftUI/View/lookAroundViewer(isPresented:initialScene:allowsNavigation:showsRoadLabels:pointsOfInterest:onDismiss:)>

  <doc://com.apple.documentation/documentation/SwiftUI/View/lookAroundViewer(isPresented:scene:allowsNavigation:showsRoadLabels:pointsOfInterest:onDismiss:)>


---

Copyright &copy; 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)