MapLookAround# PRO

MapLookAround resolves a LookAround (street-level) scene reference for a coordinate. Pair with the <LookAroundPreview> view to render the scene interactively.

import { LookAroundPreview, useEffect, useState } from "scripting"

function Example() {
  const [scene, setScene] = useState<MapLookAroundScene | null>(null)
  useEffect(() => {
    MapLookAround.request({ latitude: 37.3349, longitude: -122.0090 })
      .then(setScene)
  }, [])
  return <LookAroundPreview scene={scene} frame={{ height: 240 }} />
}

#request — fetch a scene

const scene = await MapLookAround.request({
  latitude: 31.2397,
  longitude: 121.4994,
})
if (scene == null) {
  // No street view available at this location.
}

scene is an opaque handle backed by MKLookAroundScene. Two readable fields in JS:

#<LookAroundPreview scene> — render the scene

The component also accepts all standard layout / framing modifiers (frame={...}, padding, clipShape, etc.).

#Notes

• LookAround coverage skews to major US / EU / JP / KR cities; many locations resolve to null. Always handle the null branch in your UI.
• The view uses Apple's interactive preview internally — you can't add custom overlays or annotations on top.
• A scene reference stays valid while the JS context lives; you don't need to dispose it.