外卖快速接入

用平台已有的订单与坐标直接接入地图、骑手位置展示、商家选址和 Android 原生导航。SDK 不代替平台的订单、上传队列或权限系统。

打开网页案例 · 下载 Android 案例与配套 SDK

网页：配送地图与入口选址

下载当前 JS 完整包，从包根目录启动本地 HTTP 服务，打开 examples/delivery-web/。填写已绑定当前 Origin 的 WEB Key，数据集使用实际授权的数据集；线上案例已配置演示授权，打开即可体验。

const sdk = await SukhaSDK.load({ key, serviceBaseUrl: 'https://map.sukha.cn', datasetId: 'shan' });
const tracking = new sdk.DeliveryTrackingMap('map', { orderId: 'your-order-id' });
// 从平台接口取得完整快照，保留真实测量时间和递增序号。
tracking.update(snapshot);
// 页面结束时释放组件。
tracking.destroy();

切换“后台商家选址”，用 DeliveryPlacePicker 的 confirm 事件取得入口坐标、名称与地址，由平台自己的接口保存。案例位置为明确标注的模拟数据，仅用于页面显示，不上传生产订单或骑手轨迹。

Android：定位、测距与内置导航

打开客户包中的 examples/delivery-android，按 sdk.properties.example 配置自己的 Android Key、服务地址及数据集，并登记实际包名和签名证书。示例只依赖配套的 maps-delivery 编译库。

直接安装本页下载入口提供的“外卖快速接入示例”APK，可输入目的地、打开 SDK 内置汽车导航、选择取货与送货阶段，并体验单次定位和距离卡。定位和通知使用 Android 正常权限提示。

持续定位由宿主的 DeliveryLocationClient 管理；定位结果交给客户已有的异步上传队列。导航通过 SukhaNaviPage 与 DeliveryNaviParams 调用，平台提供任务 ID、阶段和修订号。示例不创建生产订单，不自动上传位置或判定送达。

与完整订单案例的区别

快速接入案例直接使用平台数据；完整配送案例另提供隔离测试订单和只读查看码，用于演示 Android 与 H5 联动。两者使用相同的公开 SDK 能力。

客户包只含编译库、公开声明和审核过的接入示例；不含 SDK 实现源码、私密配置或平台后台代码。授权范围见交付边界。