首页 > 编程语言 >微信小程序地图与位置相关操作

微信小程序地图与位置相关操作

时间:2023-02-13 16:36:32浏览次数:56  
标签:function 程序 微信 地图 longitude res latitude wx


微信小程序地图与位置相关操作

  • ​​1、地图​​
  • ​​1.1 map的API​​
  • ​​1.2 简单地图示例​​
  • ​​1.3 MapContext对象常用操作​​
  • ​​1.4 地图操作示例​​
  • ​​2、位置​​
  • ​​2.1 位置API​​
  • ​​2.1.1 wx.getLocation(Object object)​​
  • ​​2.1.2 wx.openLocation(Object object)​​
  • ​​2.1.3 wx.chooseLocation()​​
  • ​​2.2 wx.openLocation()案例​​
  • ​​2.3 wx.chooseLocation()案例​​

1、地图

  map是一个比较复杂的组件,他有很多参数,如下表所示。

1.1 map的API

属性

类型

默认值

必填

说明

最低版本

longitude

number


中心经度

​1.0.0​

latitude

number


中心纬度

​1.0.0​

scale

number

16


缩放级别,取值范围为3-20

​1.0.0​

min-scale

number

3


最小缩放级别

​2.13.0​

max-scale

number

20


最大缩放级别

​2.13.0​

markers

Array.



标记点

​1.0.0​

covers

Array.


即将移除,请使用 markers

​1.0.0​

polyline

Array.



路线

​1.0.0​

circles

Array.




​1.0.0​

controls

Array.


控件(即将废弃,建议使用 ​​cover-view​​ 代替)

​1.0.0​

include-points

Array.


缩放视野以包含所有给定的坐标点

​1.0.0​

show-location

boolean

false


显示带有方向的当前定位点

​1.0.0​

polygons

Array.



多边形

​2.3.0​

subkey

string


个性化地图使用的key

​2.3.0​

layer-style

number

1


个性化地图配置的 style,不支持动态修改

rotate

number

0


旋转角度,范围 0 ~ 360, 地图正北和设备 y 轴角度的夹角

​2.5.0​

skew

number

0


倾斜角度,范围 0 ~ 40 , 关于 z 轴的倾角

​2.5.0​

enable-3D

boolean

false


展示3D楼块(工具暂不支持)

​2.3.0​

show-compass

boolean

false


显示指南针

​2.3.0​

show-scale

boolean

false


显示比例尺,工具暂不支持

​2.8.0​

enable-overlooking

boolean

false


开启俯视

​2.3.0​

enable-zoom

boolean

true


是否支持缩放

​2.3.0​

enable-scroll

boolean

true


是否支持拖动

​2.3.0​

enable-rotate

boolean

false


是否支持旋转

​2.3.0​

enable-satellite

boolean

false


是否开启卫星图

​2.7.0​

enable-traffic

boolean

false


是否开启实时路况

​2.7.0​

enable-poi

boolean

true


是否展示 POI 点

​2.14.0​

enable-building

boolean


是否展示建筑物

​2.14.0​

setting

object


配置项

​2.8.2​

bindtap

eventhandle


点击地图时触发,​​2.9.0​​起返回经纬度信息

​1.0.0​

bindmarkertap

eventhandle


点击标记点时触发,​​e.detail = {markerId}​

​1.0.0​

bindlabeltap

eventhandle


点击label时触发,​​e.detail = {markerId}​

​2.9.0​

bindcontroltap

eventhandle


点击控件时触发,​​e.detail = {controlId}​

​1.0.0​

bindcallouttap

eventhandle


点击标记点对应的气泡时触发​​e.detail = {markerId}​

​1.2.0​

bindupdated

eventhandle


在地图渲染更新完成时触发

​1.6.0​

bindregionchange

eventhandle


视野发生变化时触发,

​2.3.0​

bindpoitap

eventhandle


点击地图poi点时触发,​​e.detail = {name, longitude, latitude}​

​2.3.0​

bindanchorpointtap

eventhandle


点击定位标时触发,​​e.detail = {longitude, latitude}​

​2.13.0​

  map组件的两个属性longitude和latitude表示当前地图中心的经度和纬度,和当前用户所在位置的经度和纬度是不同概念,无直接关系。例如,某然在广东省东菀市,但是可以打开北京天安门为中心的一幅地图,map的longitude和latitude是用来控制地图中心的参数,并不是用户实时的地理位置。

1.2 简单地图示例

pages/map/map.wxml

<map id="tu" latitude='23.099' longitude='113.325'  scale='12' class="tu" controls='{{con}}' markers='{{mar}}' bindcontroltap='con' bindmarkertap='mar'>
</map>

pages/map/map.js

Page({

data: {
mar:[{
inconPath:"location.png",
id:0,
latitude:23.088994,
longitude:113.324520,
width:50,
heigth:50

}
]
},

con:[{
id:1,
iconPath:'location.png',
positon:{left:0,
top:50,
width:50,
height:50},
clickable:true
}],

mar:function(e)
{console.log("你点了标记点")},

con: function (e) { console.log("你点了游标") }
})

微信小程序地图与位置相关操作_微信小程序

  map只能简单地生成一幅地图,要对地图进行操作,如进行缩放和移动操作,开发者必须在JS中获取MapContext对象,这时需要通过​​wx.createMapContext('id')​​​获取MapContext对象。你可以理解为​​wx.createMapContext('id')​​就是指向地图的一个指针。

1.3 MapContext对象常用操作

接口

功能和用途

MapContext.getCenterLocation(Object object)

获取当前地图中心的经纬度。返回的是 gcj02 坐标系,可以用于 ​​wx.openLocation()​

MapContext.setLocMarkerIcon(Object object)

设置定位点图标,支持网络路径、本地路径、代码包路径

MapContext.moveToLocation(Object object)

将地图中心移置当前定位点,此时需设置地图组件 show-location 为true。​​‘2.8.0’​​ 起支持将地图中心移动到指定位置。

MapContext.translateMarker(Object object)

平移marker,带动画。

MapContext.includePoints(Object object)

缩放视野展示所有经纬度

MapContext.getRegion(Object object)

获取当前地图的视野范围

MapContext.getScale(Object object)

获取当前地图的缩放级别

  需要说明的是MapContext.getRegion()接口获取图片的范围,即是经度和纬度的取值范围,取值范围是以地图的西南和东北两个顶点的经度和纬度来限定的。MapContext.translateMarker()和MapContext.includePoints()两个接口中需要用到的经度和纬度不能超出MapContext.getRegion()接口的经度和纬度取值范围。

1.4 地图操作示例

MapContext.wxml

<map 
id="ditu"
style="width: 710rpx; height: 250px;"
latitude="{{latitude}}"
longitude="{{longitude}}"
markers="{{markers}}"
show-location>
</map>
<button bindtap="getCenterLocation" type="primary">获取地图中心的经纬度</button>
<button bindtap="moveToLocation" type="primary">将地图中心移动到当前定位点</button>
<button bindtap="translateMarker" type="primary">平移marker,带动画</button>
<button bindtap="includePoints" type="primary">缩放视野展示所有经纬度</button>
<button bindtap="scaleClick" type="primary">获取当前地图的缩放级别</button>
<button bindtap="getRegionClick" type="primary">获取当前地图的视野范围</button>

MapContext.js

Page({
data: {
latitude: 22.557416086996245,
longitude: 113.3832685578842,
markers: [{
id: 1,
latitude: 22.557416086996245,
longitude: 113.3832685578842,
name: '中山北站'
}],
},
onReady: function (e) {
//创建 map 上下文 MapContext 对象。
this.zhizhen = wx.createMapContext('ditu')
},
//获取当前地图中心的经纬度
getCenterLocation: function () {
this.zhizhen.getCenterLocation({
success: function (res) {
console.log(res.longitude)
console.log(res.latitude)
}
})
},
//将地图中心移动到当前定位点
moveToLocation: function () {
this.zhizhen.moveToLocation()
},
//平移marker,带动画
translateMarker: function () {
this.zhizhen.translateMarker({
markerId: 1,
autoRotate: true,
duration: 2000,
destination: {
latitude: 22.55229,
longitude: 113.3845211,
},
animationEnd() {
console.log('animation end')
}
})
},
//缩放视野展示所有经纬度
includePoints: function () {
this.zhizhen.includePoints({
padding: [10],
points: [{
latitude: 22.54229,
longitude: 113.3745211,
}, {
latitude: 22.55229,
longitude: 113.3845211,
}]
})
},
//获取当前地图的缩放级别
scaleClick: function () {
this.zhizhen.getScale({
success: function (res) {
console.log(res.scale)
}
})
},
//获取当前地图的视野范围
getRegionClick: function () {
this.zhizhen.getRegion({
success: function (res) {
console.log(res.southwest)//西南角经纬度
console.log(res.northeast)//东北角经纬度
}
})
}
})

微信小程序地图与位置相关操作_微信小程序_02

  点击获取地图中心的经纬度

微信小程序地图与位置相关操作_git_03

  获取当前地图的视野范围:

微信小程序地图与位置相关操作_前端_04

  将地图中心移动到当前定位点:

微信小程序地图与位置相关操作_微信小程序_05


平移marker:

小程序地图操作

2、位置

  小程序常用下面三个接口对位置进行操作。

2.1 位置API

2.1.1 wx.getLocation(Object object)

  该接口获取当前的地理位置

属性

类型

默认值

必填

说明

最低版本

type

string

wgs84


wgs84 返回 gps 坐标,gcj02 返回可用于 wx.openLocation 的坐标

altitude

boolean

false


传入 true 会返回高度信息,由于获取高度需要较高精确度,会减慢接口返回速度

​1.6.0​

isHighAccuracy

boolean

false


开启高精度定位

​2.9.0​

highAccuracyExpireTime

number


高精度定位超时时间(ms),指定时间内返回最高精度,该值3000ms以上高精度定位才有效果

​2.9.0​

success

function


接口调用成功的回调函数

fail

function


接口调用失败的回调函数

complete

function


接口调用结束的回调函数(调用成功、失败都会执行)

2.1.2 wx.openLocation(Object object)

  使用微信内置地图查看位置

属性

类型

默认值

必填

说明

latitude

number


纬度,范围为-90~90,负数表示南纬。使用 gcj02 国测局坐标系

longitude

number


经度,范围为-180~180,负数表示西经。使用 gcj02 国测局坐标系

scale

number

18


缩放比例,范围5~18

name

string


位置名

address

string


地址的详细说明

success

function


接口调用成功的回调函数

fail

function


接口调用失败的回调函数

complete

function


接口调用结束的回调函数(调用成功、失败都会执行)

示例代码:

wx.getLocation({
type: 'gcj02', //返回可以用于wx.openLocation的经纬度
success (res) {
const latitude = res.latitude
const longitude = res.longitude
wx.openLocation({
latitude,
longitude,
scale: 18
})
}
})

2.1.3 wx.chooseLocation()

  打开地图选择位置。

属性

类型

默认值

必填

说明

最低版本

latitude

number


目标地纬度

​2.9.0​

longitude

number


目标地经度

​2.9.0​

success

function


接口调用成功的回调函数

fail

function


接口调用失败的回调函数

complete

function


接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

参数

Object res

属性

类型

说明

name

string

位置名称

address

string

详细地址

latitude

number

纬度,浮点数,范围为-90~90,负数表示南纬。使用 gcj02 国测局坐标系

longitude

number

经度,浮点数,范围为-180~180,负数表示西经。使用 gcj02 国测局坐标系

2.2 wx.openLocation()案例

pages/openLocation/openLocation.js

//获取应用实例
var app = getApp()
Page({
data: {
motto: 'Hello World',
userInfo: {}
},
//事件处理函数
bindViewTap: function () {
wx.navigateTo({
url: '../logs/logs'
})
},
onl oad: function () {
console.log('onLoad')
var that = this
//调用应用实例的方法获取全局数据
app.getUserInfo(function (userInfo) {
//更新数据
that.setData({
userInfo: userInfo
})
})
wx.getLocation({
type: 'gcj02', // 返回可以用于wx.openLocation的经纬度
success(res) {
const latitude = res.latitude
const longitude = res.longitude
console.log(latitude + "---" + longitude)
wx.openLocation({
latitude,
longitude,
scale: 18
})
}
})

}
})

微信小程序地图与位置相关操作_git_06

微信小程序地图与位置相关操作_缩放_07

  这里先用​​wx.getLocation()​​​接口获取经度和纬度,再用​​wx.openLocation()​​​接口使用​​wx.getLocation()​​接口获取的经度和纬度打开位置地图。

2.3 wx.chooseLocation()案例

pages/chooseLocation/chooseLocation.js

//获取应用实例
var app = getApp()
Page({
data: {
motto: 'Hello World',
userInfo: {}
},
//事件处理函数
bindViewTap: function() {
wx.navigateTo({
url: '../openLocation/openLocation'
})
},
onl oad: function () {
console.log('onLoad')
var that = this
//调用应用实例的方法获取全局数据
app.getUserInfo(function(userInfo){
//更新数据
that.setData({
userInfo:userInfo
})
})


wx.getLocation({
type: 'wgs84', // 默认为 wgs84 返回 gps 坐标,gcj02 返回可用于 wx.openLocation 的坐标
success: function(res){
var latitude = res.latitude
var longitude = res.longitude
wx.chooseLocation({
latitude: latitude,
longitude: longitude,
success: function(res){
console.log(res)
},
fail: function() {
// fail
},
complete: function() {
// complete
}
})
},
fail: function() {
// fail
},
complete: function() {
// complete
}
})

}
})

  本例先用​​wx.getLocation()​​​接口获取经度和纬度,再用​​wx.chooseLocation()​​​接口使用​​wx.getLocation()​​​接口获取的经度和纬度选择打开地图位置,运行效果如下所示,注意在其右上角有一个“确定”按钮,该按钮即为​​wx.chooseLocation()​​接口选择二字的含义所在。

微信小程序地图与位置相关操作_微信小程序_08


标签:function,程序,微信,地图,longitude,res,latitude,wx
From: https://blog.51cto.com/u_15961549/6054471

相关文章