更新记录

1.0.0（2026-07-19）

初始化

平台兼容性

uni-app(3.7.11)

uni-app x(4.45)

xtf-baiduselectpos

百度地图选点插件，提供原生位置选择界面，支持 Android、iOS、Harmony。

功能说明

• 打开地图选点页，返回用户最终选择的位置
• 支持默认中心点、默认关键词、默认城市
• 支持返回 BD09LL 或 GPS(WGS84) 坐标
• 支持顶部文案、搜索文案、按钮颜色、列表颜色等 UI 自定义

支持平台

使用前说明

1. 需要分别配置百度地图平台 Key：android_key、ios_key、harmony_key。
2. iOS 端依赖原生 SDK，必须使用自定义基座运行，不能只用标准基座验证。
3. 地图内部搜索与展示使用百度坐标系 BD09LL，仅最终成功回调可按 returnCoordinateType 转成 GPS。

导出方法

openLocationPicker(options)

作用：打开百度地图位置选择页面，用户确认后返回所选地点信息。

uni-app x 导入方式

import { openLocationPicker } from '@/uni_modules/xtf-baiduselectpos'

uni-app 导入方式

import { openLocationPicker } from '@/uni_modules/xtf-baiduselectpos'

参数 OpenLocationPickerOptions

success(res) 回调作用

作用：在用户确认位置后返回最终选中的地点信息。

fail(err) 回调作用

作用：在打开页面失败、缺少 Key、地图 SDK 初始化失败等场景下返回错误信息。

常见错误码说明：

complete(res) 回调作用

作用：无论成功还是失败都会执行，适合做统一收尾处理，比如关闭 loading、记录日志。

使用示例

uni-app x

import { openLocationPicker, type OpenLocationPickerOptions } from '@/uni_modules/xtf-baiduselectpos'

const options: OpenLocationPickerOptions = {
  android_key: 'your-android-key',
  ios_key: 'your-ios-key',
  harmony_key: 'your-harmony-key',
  keyword: '写字楼',
  city: '北京',
  returnCoordinateType: 'GPS',
  confirmText: '确定',
  success(res) {
    console.log('select success', res)
  },
  fail(err) {
    console.log('select fail', err)
  },
  complete(res) {
    console.log('select complete', res)
  }
}

openLocationPicker(options)

uni-app

import { openLocationPicker } from '@/uni_modules/xtf-baiduselectpos'

openLocationPicker({
  android_key: 'your-android-key',
  ios_key: 'your-ios-key',
  harmony_key: 'your-harmony-key',
  keyword: '写字楼',
  city: '北京',
  returnCoordinateType: 'GPS',
  confirmText: '确定',
  success(res) {
    console.log('select success', res)
  },
  fail(err) {
    console.log('select fail', err)
  },
  complete(res) {
    console.log('select complete', res)
  }
})

坐标说明

• BD09LL：百度坐标系，插件默认返回值
• GPS：WGS84 坐标，适合与通用 GPS 坐标系统对接

适用场景

• 地址选择
• 门店选址
• 上门服务定位
• 表单中补充经纬度和详细地址