下面我将详细讲解使用微信小程序内地图的操作步骤和注意事项,以及两条示例说明。
一、前期准备
1. 开通小程序云开发环境
首先需要开通小程序云开发环境,可以参考微信官方文档进行操作。
2. 获取高德地图API Key
在使用高德地图之前,需要在高德开放平台上注册账号,并获取API Key。具体流程可以参考高德地图官方文档。
3. 安装必要的npm包
使用微信小程序地图,需要安装以下三个npm包:
- 微信小程序原生SDK:
@tencent/map-wx-sdk
- 高德地图SDK:
@amap/amap-jsapi-loader
- geolib:
geolib
可以通过以下命令安装:
npm install --production @tencent/map-wx-sdk @amap/amap-jsapi-loader geolib
完成上述步骤后,我们就可以开始操作了。
二、实现地图显示和标注
1. 创建地图
首先在wxml页面中创建一个地图组件,代码如下:
<map id="map" latitude="{{latitude}}" longitude="{{longitude}}" markers="{{markers}}" />
其中,id
为地图组件的唯一标识符,latitude
和longitude
分别为地图初始化时的中心点坐标,markers
为标注点数组。
2. 初始化地图
接下来,在页面的js文件中初始化地图。具体步骤如下:
const amapFile = require('@amap/amap-jsapi-loader');
Page({
data: {
latitude: 39.90469,
longitude: 116.40717,
markers: [],
},
async onLoad() {
// 获取高德地图API Key,注意替换YOUR_AMAP_API_KEY为自己的API Key。
const apiKey = 'YOUR_AMAP_API_KEY';
// 加载高德地图JSAPI
const { AMap } = await amapFile.load({
"key": apiKey,
"version": "2.0",
"plugins": [],
});
// 初始化地图
const map = new AMap.Map('map', {
zoom: 12,
center: [this.data.longitude, this.data.latitude],
});
this.setData({
map: map
});
},
});
在上面的代码中,我们首先从@amap/amap-jsapi-loader
包中引入了AMap
对象,然后通过new AMap.Map
初始化地图,并将地图对象保存在页面数据中,以便之后的操作中使用。
3. 添加标注
最后,我们可以使用以下代码添加标注点:
const marker = new AMap.Marker({
position: [longitude, latitude],
icon: 'path/to/icon.png',
title: '这是一个标注点',
});
this.data.map.add(marker);
this.setData({
markers: [...this.data.markers, marker]
});
其中,position
为标注点的经纬度坐标,icon
为标注点的图标,title
为标注点的标题。添加完标注点后,需要将标注点对象保存在页面数据中,并更新markers
数据,以便在地图组件中显示出来。
三、综合应用示例
接下来,我将给出两个示例,分别演示地点搜索和路径规划功能。
1. 地点搜索
以下示例可以根据输入的地址,搜索该地址附近的餐馆,并在地图上显示出来。代码如下:
const amapFile = require('@amap/amap-jsapi-loader');
const geolib = require('geolib');
Page({
data: {
latitude: 0,
longitude: 0,
markers: [],
},
async onLoad() {
const apiKey = 'YOUR_AMAP_API_KEY';
const { AMap } = await amapFile.load({
"key": apiKey,
"version": "2.0",
"plugins": [],
});
const map = new AMap.Map('map', {
zoom: 12,
center: [this.data.longitude, this.data.latitude],
});
// 输入地址查询附近的餐馆
const p = new Promise((resolve, reject) => {
AMap.service('AMap.PlaceSearch', {
pageSize: 10, // 最多返回多少条数据
city: '北京市',
extensions: 'all',
map,
}, (status, result) => {
if (status === 'complete') {
resolve(result.poiList.pois);
} else {
reject(result);
}
});
});
// 根据查询结果添加Marker
const addMarkers = (pois) => {
const markers = [];
pois.forEach((poi) => {
const marker = new AMap.Marker({
position: [poi.location.lng, poi.location.lat],
title: poi.name,
});
markers.push(marker);
});
this.setData({
markers: markers,
});
};
// 根据输入地址返回坐标
const getCoord = (addr) => {
return new Promise((resolve, reject) => {
AMap.plugin('AMap.Geocoder', function() {
const geocoder = new AMap.Geocoder({
city: '北京市',
});
geocoder.getLocation(addr, function(status, result) {
if (status === 'complete' && result.geocodes.length) {
const location = result.geocodes[0].location;
const { longitude, latitude } = location;
resolve({ longitude, latitude });
} else {
reject(result);
}
});
});
});
};
// 等待地理编码完成后,调用输入地址查询附近餐馆的方法
const searchNearby = async (addr) => {
try {
const coord = await getCoord(addr);
this.setData({
longitude: coord.longitude,
latitude: coord.latitude,
})
map.setZoomAndCenter(14, [coord.longitude, coord.latitude]);
const pois = await p;
addMarkers(pois);
} catch (e) {
console.error(e);
}
};
// 示例调用
searchNearby('北京市朝阳区');
},
});
在上述示例中,我们使用了高德地图的AMap.PlaceSearch
插件,根据输入的地址返回附近的餐馆,并将餐馆的位置信息添加到地图上。
2. 路径规划
以下示例可以根据起点和终点,规划出两点之间的路线,并在地图上显示出来。代码如下:
const amapFile = require('@amap/amap-jsapi-loader');
const geolib = require('geolib');
Page({
data: {
latitude: 0,
longitude: 0,
markers: [],
},
async onLoad() {
const apiKey = 'YOUR_AMAP_API_KEY';
const { AMap } = await amapFile.load({
"key": apiKey,
"version": "2.0",
"plugins": [],
});
const map = new AMap.Map('map', {
zoom: 12,
center: [this.data.longitude, this.data.latitude],
});
// 根据起点和终点查询路线
const searchPath = (start, end) => {
return new Promise((resolve, reject) => {
// 根据地址查询坐标,完成后再根据坐标查询路线
AMap.plugin('AMap.Geocoder', function() {
const geocoder = new AMap.Geocoder({
city: '北京市',
});
Promise.all([geocoder.getLocation(start), geocoder.getLocation(end)])
.then((locations) => {
const [startLoc, endLoc] = locations;
const path = new AMap.Driving({
policy: AMap.DrivingPolicy.LEAST_TIME,
extensions: 'base',
map,
});
const startLngLat = new AMap.LngLat(startLoc.longitude, startLoc.latitude);
const endLngLat = new AMap.LngLat(endLoc.longitude, endLoc.latitude);
path.search(startLngLat, endLngLat, (status, result) => {
if (status === 'complete' && result.routes && result.routes.length) {
resolve(result.routes[0].path);
} else {
reject(result);
}
});
})
.catch((e) => {
reject(e);
})
});
});
};
// 将路径信息添加到地图上
const addPath = (path) => {
const markers = [];
const polylines = [];
path.forEach((p, index) => {
if (index === 0 || index === path.length - 1) {
// 添加起点和终点标记
const marker = new AMap.Marker({
position: [p.lng, p.lat],
icon: `https://webapi.amap.com/theme/v1.3/markers/n/start.png`,
});
markers.push(marker);
} else {
// 添加步行路线
const prev = path[index - 1];
const distance = geolib.getDistance({ longitude: prev.lng, latitude: prev.lat }, { longitude: p.lng, latitude: p.lat });
if (distance > 50) {
const polyline = new AMap.Polyline({
path: [prev, p],
extData: {
distance: distance,
},
strokeColor: "#0091FF",
strokeWeight: 6,
strokeOpacity: 1,
strokeStyle: "solid",
});
polylines.push(polyline);
}
}
});
map.add(markers.concat(polylines));
};
// 示例调用
searchPath('北京站', '天安门')
.then((path) => {
this.setData({
longitude: path[0].lng,
latitude: path[0].lat,
});
map.setZoomAndCenter(13, [path[0].lng, path[0].lat]);
addPath(path);
})
.catch((e) => {
console.error(e);
});
},
});
在上述示例中,我们使用了高德地图的AMap.Geocoder
和AMap.Driving
插件,根据输入的起点和终点返回两点之间的路线,并将路线信息添加到地图上。
以上就是关于使用微信小程序内地图的一些实战记录,希望对您有所帮助。
本站文章如无特殊说明,均为本站原创,如若转载,请注明出处:一次微信小程序内地图的使用实战记录 - Python技术站