唯一支持纯HTML嵌入街景的是腾讯地图iframe方案；百度、高德、Google均需加载SDK并调用JS类；自托管需equirectangular全景图+HTTP服务+正确CORS配置。
直接用原生 HTML + JavaScript 调用地图厂商的街景 API 是可行的，但必须明确一点：没有哪家支持“纯 HTML 标签”实现街景——
嵌入是唯一免 JS 集成的方式，且仅限腾讯地图；其余（Google、百度、高德）都强制要求加载 SDK 并调用 JS 类（如
、
、
），否则页面白屏或报错
。
腾讯地图 URL Scheme 街景嵌入（唯一真·HTML 方式）
这是目前唯一不需要写一行 JS 就能展示街景的方案，本质是拼接腾讯官方开放的街景跳转链接，并用
加载。适用于快速预览、H5 落地页、CMS 内容嵌入等轻量场景。
URL 格式固定：
，其中
是必填的街景唯一 ID（PanoId）
不能凭空生成，需先用
或百度/腾讯地图网页版手动点进街景后从地址栏提取（例如
）
直接在 HTML 中写：
缺点明显：无法控制视角动画、无 API 回调、不支持坐标定位（只能靠已知 PanoId）、iOS 微信内可能被拦截跳转
百度地图
初始化失败常见原因
新手最常卡在“页面空白+控制台报错”，核心问题不是代码写错，而是环境没配对。
必须确保
全景图必须是等距圆柱投影（equirectangular）格式，分辨率建议 4096×2048 或 8192×4096；非标准尺寸会导致拉伸或黑边
初始化只需一个
和几行 JS：
关键注意：服务器必须允许跨域（CORS），否则图片加载失败且控制台只报
；本地双击 HTML 打开会因 file:// 协议被浏览器拦截，务必用
或 VS Code Live Server 启服务
真正卡住项目的从来不是“怎么写代码”，而是搞不清每个服务商的数据边界——百度不返回海洋坐标街景、腾讯不支持动态坐标搜索、Google 在国内基本不可用、自托管全景图又绕不开 CORS 和投影格式。动手前先查清你要展示的位置是否真实存在街景数据，比写十遍初始化逻辑都重要。
iframeBMap.Panoramaqq.maps.StreetViewServicegoogle.maps.StreetViewPanoramaReferenceError: BMap is not definediframehttps://map.qq.com/?type=streetview&pano=xxx&heading=0&pitch=0&zoom=1panopanoqq.maps.PanoramaService.getPano()pano=09001900011610281321007255FBMap.Panoramaconst viewer = new PhotoSphereViewer({ panorama: 'assets/scene.jpg', container: 'psv', loading_img: 'assets/loader.gif'});net::ERR_FAILEDpython3 -m http.server