crush-location

1.0.7 • Public • Published

定位功能测试插件

集合了高德地图和腾讯地图的精准定位(浏览器定位)、IP定位、地址解析、逆地址解析相关方法。

仅供个人测试使用,切勿应用于真实项目。


1. 规范

本插件采用CommonJS规范。


2. 使用

(1) 初始化 init(brand, options)

参数 类型 是否必传 说明
brand String true 该参数只可传两个值:geo或qq,以区别使用高德地图还是腾讯地图
options Object true 相关配置项
options.key String true 该参数为申请高德/腾讯地图API时的key值
options.sk String false 高德地图API安全密钥,自2021年12月02日高德地图升级之后所申请的 key 必须配备安全密钥一起使用
options.referer String false 腾讯地图API应用名称,若选择使用腾讯地图API,该值必传

该方法返回一个Promiseresolve一个对象,该对象中共4个方法:

  • getLocation

  • getIpLocation

  • getAddress

  • getPosition

(2) 精准定位(浏览器定位) getLocation(type)

参数 类型 是否必传 说明
type String 该参数只可传两个值:jsapi或webapi
jsapi:使用组件的方式获取定位
webapi:使用web服务(http请求)的方式获取定位

该方法返回一个Promise

(3) IP定位 getIpLocation(type)

参数和返回同精准定位

(4) 逆地址解析 getAddress(type, lng, lat)

参数 类型 是否必传 说明
type String 该参数只可传两个值:jsapi或webapi
jsapi:使用组件的方式获取定位
webapi:使用web服务(http请求)的方式进行解析
lng Number 经度
lat Number 纬度

该方法返回一个Promise

(5) 地址解析 getPosition(type, address)

参数 类型 是否必传 说明
type String 该参数只可传两个值:jsapi或webapi
jsapi:使用组件的方式获取定位
webapi:使用web服务(http请求)的方式进行解析
address String 地址描述,如浙江省滨江区长河街道

该方法返回一个Promise


3. 注意事项

使用腾讯地图API通过http请求的方式获取定位或解析,存在跨域问题,本地调试需进行代理,webpack配置如下:

proxy: {
    '/location': {
        target: 'https://apis.map.qq.com',
        changeOrigin: true,
        pathRewrite: { '^/location': '' },
    },
},

Package Sidebar

Install

npm i crush-location

Weekly Downloads

3

Version

1.0.7

License

ISC

Unpacked Size

15 kB

Total Files

10

Last publish

Collaborators

  • lonelytaker