二次开发
GeoTwin SDK 提供平台应用所使用的场景与视图 API。可以用它嵌入场景、开发自定义工具，或扩展现有地图应用。
开始之前
- 一个已发布的场景及其引用的服务。
- 有权限读取这些服务的项目账号。
- 启用 WebGL 的浏览器。
- 随部署提供的 SDK 构建产物，或 GeoTwin 对接人提供的安装包。
基本流程
- 创建有明确宽高的容器元素。
- 在业务脚本之前加载 SDK 资源。
- 使用容器 id 与配置创建
Viewer。
- 加载场景或添加图层。
- 注册需要的事件，页面销毁时清理 viewer。
<div id="map-container" style="width: 100%; height: 100%"></div>
const viewer = new Viewer('map-container', {
// 配置项取决于部署环境与场景
});
// 加载场景；页面关闭时释放资源。
// viewer.destroy();
具体的构造参数与场景加载调用，以随 SDK 提供的类型定义和下方 API 页面为准。
API 参考
| API |
用途 |
| Viewer |
地图与三维视图、相机、图层、事件 |
| Scene |
场景图、导航、高亮、书签 |
| CompositeViewer |
组合三维、二维地图与全景视图 |
| PanoramaViewer |
全景点、切换与截屏 |
| NodeData |
图层、模型与标注的节点结构 |
约定
- 把 SDK 当作外部依赖，固定业务应用使用的版本。
- 一个容器只创建一个 viewer，不要向同一元素重复追加。
- 离开页面时移除事件监听并调用
destroy()。
- 在与目标用户相同的浏览器和显卡档次上测试。
支持
SDK 版本、安装包与兼容性问题，请联系 GeoTwin 项目对接人。反馈问题时请附平台版本、SDK 版本与最小复现步骤。