百度地图

组件说明

百度地图组件用于在表单中选择地理位置,基于百度地图API实现。

用法示例

use plugin\xbCode\builder\Builder;
use plugin\xbCode\builder\Renders\Form;

Builder::form(function (Form $builder) {
    // 添加百度地图组件
    $builder->addRowBmapPicker('address', '地址选择', '', function($component) {
        $component->ak('your-baidu-map-ak'); // 设置百度地图AK
        $component->placeholder('请选择地址');
        $component->autoSelectCurrentLoc(true);
    });

    // 或使用数组配置
    $builder->addRowBmapPicker('location', '位置', '', [
        'ak' => 'your-baidu-map-ak',
        'clearable' => true,
        'onlySelectCurrentLoc' => false
    ]);
});

组件参数

参数名类型默认值说明
namestring-字段名称
labelstring-字段标签
valuemixed-默认值
vendorstring'baidu'地图厂商,默认为baidu(百度地图)
akstring-百度地图的AK密钥(必填)
coordinatesTypestring'bd09'坐标系类型,百度地图默认使用bd09坐标系
staticboolfalse是否静态展示
clearableboolfalse输入框是否可清空
placeholderstring-默认提示文本
autoSelectCurrentLocboolfalse是否自动选中当前地理位置
onlySelectCurrentLocboolfalse是否限制只能选中当前地理位置
staticSchemaarray-静态展示额外配置
requiredboolfalse是否必填
disabledboolfalse是否禁用
hiddenboolfalse是否隐藏

使用说明

  1. 使用前需要申请百度地图AK密钥
  2. 百度地图使用bd09坐标系
  3. 组件会返回包含经纬度和地址信息的对象
  4. 支持点击地图选择位置或搜索地址
  5. 可配置为定位组件使用(设置onlySelectCurrentLoc为true)