浏览 SDKs · Flutter
平台
SDKsFlutter

创建位置消息

使用 Flutter SDK 创建位置消息。

复制

指定经纬度坐标与地名描述,构建待发送的地理位置消息对象:

参数说明

参数类型是否必填说明
latitudedouble是地理纬度。
longitudedouble是地理经度。
descriptionString是位置描述或地标建筑名称(如“台北 101”)。
final message = await OpenIM.iMManager.messageManager.createLocationMessage(
  latitude: 25.033,
  longitude: 121.5654,
  description: '台北 101',
);

调用前应由业务层获取设备定位权限并校验经纬度有效性。

返回结果

Future 成功返回待发送的位置消息对象(Message),其位置数据存储在 locationElem 中。

创建操作仅在本地组装消息数据,不会自动执行网络发送,也不会触发新消息事件通知。构建完成后,需将返回的 Message 实例传给发送消息投递至单聊或群聊会话。