騰訊位置服務API是可以給開發人員調用的開發API ,程序員可以用Javascript的語言進行調用,只需要通過一個URL地址便可以進行引用,便可以調用騰訊位置服務的API。本文結合開發中的打卡示例來講解騰訊地圖 Javascript API 該如何使用。
1. 註冊賬號
a. 註冊成爲開發者 b. 申請密鑰,在如圖位置創建新密鑰 c. 進行配置 推薦使用授權IP的方式進行配置,將你個人的IP寫進輸入框就OK啦!
2.使用官方Api進行地圖標記(JavaScript)
2.1 通過搜索接口找到個人公司位置:
key換成你的 查詢到公司位置爲(31.329716,121.508386)
2.2 初始化地圖,中心設爲公司位置
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Hello world!</title>
<style type="text/css">
#container{
/*地圖(容器)顯示大小*/
width:1200px;
height:400px;
}
</style>
<!--引入Javascript API GL,參數說明參見下文-->
<script src="https://map.qq.com/api/gljs?v=1.exp&key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77"></script>
<script>
//地圖初始化函數,本例取名爲init,開發者可根據實際情況定義
function initMap() {
//定義地圖中心點座標
var center = new TMap.LatLng(31.329716, 121.508386);
//定義map變量,調用 TMap.Map() 構造函數創建地圖
var map = new TMap.Map(document.getElementById('container'), {
center: center,//設置地圖中心點座標
viewMode:'2D',//設置顯示模式 2D 3D可以自己修改
zoom: 17.2, //設置地圖縮放級別
pitch: 43.5, //設置俯仰角
rotation: 45 //設置地圖旋轉角度
});
}
</script>
</head>
<!-- 頁面載入後,調用init函數 -->
<body onload="initMap()">
<!-- 定義地圖顯示容器 -->
<div id="container"></div>
</body>
</html>
效果展示:
標註的位置就是設置的中心啦。
2.3 爲公司位置位置打上標記
效果示例: 公司的位置加上了style中寫的圖片,代碼如下:
<script src="https://map.qq.com/api/gljs?v=1.exp&key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77"></script>
<script>
//地圖初始化函數,本例取名爲init,開發者可根據實際情況定義
function initMap() {
//創建map對象,初始化地圖
var center = new TMap.LatLng(31.329716, 121.508386);
var map = new TMap.Map(document.getElementById('container'), {
center: center,//設置地圖中心點座標
zoom: 17.2, //設置地圖縮放級別
pitch: 43.5, //設置俯仰角
rotation: 45 //設置地圖旋轉角度
});
//創建並初始化MultiMarker
var markerLayer = new TMap.MultiMarker({
map: map, //指定地圖容器
//樣式定義
styles: {
//創建一個styleId爲"myStyle"的樣式(styles的子屬性名即爲styleId)
"myStyle": new TMap.MarkerStyle({
"width": 25, // 點標記樣式寬度(像素)
"height": 35, // 點標記樣式高度(像素)
"src": '微信圖片_20210107230437.jpg', //圖片路徑
//焦點在圖片中的像素位置,一般大頭針類似形式的圖片以針尖位置做爲焦點,圓形點以圓心位置爲焦點
"anchor": { x: 16, y: 32 }
})
},
//點標記數據數組
geometries: [{
"id": "1", //點標記唯一標識,後續如果有刪除、修改位置等操作,都需要此id
"styleId": 'myStyle', //指定樣式id
"position": new TMap.LatLng(31.329716, 121.508386), //點標記座標位置
"properties": {//自定義屬性
"title": "我的公司"
}
}
]
});
}
</script>
2.4 讓標記的點動起來
主要通過使用moveAlong方法,定義移動的軌跡path,在moveAlong中傳入移動的路線和座標點,座標點是geometries中的標記。
<script>
//地圖初始化函數,本例取名爲init,開發者可根據實際情況定義
function initMap() {
//創建map對象,初始化地圖
var center = new TMap.LatLng(31.329716, 121.508386);
var map = new TMap.Map(document.getElementById('container'), {
center: center,//設置地圖中心點座標
zoom: 17.2, //設置地圖縮放級別
pitch: 43.5, //設置俯仰角
rotation: 45 //設置地圖旋轉角度
});
//創建並初始化MultiMarker
var marker = new TMap.MultiMarker({
map: map, //指定地圖容器
//樣式定義
styles: {
//創建一個styleId爲"myStyle"的樣式(styles的子屬性名即爲styleId)
"myStyle": new TMap.MarkerStyle({
"width": 25, // 點標記樣式寬度(像素)
"height": 35, // 點標記樣式高度(像素)
"src": '微信圖片_20210107230437.jpg', //圖片路徑
//焦點在圖片中的像素位置,一般大頭針類似形式的圖片以針尖位置做爲焦點,圓形點以圓心位置爲焦點
"anchor": { x: 16, y: 32 }
})
},
//點標記數據數組
geometries: [{
"id": "person", //點標記唯一標識,後續如果有刪除、修改位置等操作,都需要此id
"styleId": 'myStyle', //指定樣式id
"position": new TMap.LatLng(31.329716, 121.508386), //點標記座標位置
"properties": {//自定義屬性
"title": "我的公司"
}}
]
});
//定義的移動路線
var path = [
new TMap.LatLng(31.329716, 121.508386),
new TMap.LatLng(31.330720, 121.508388),
new TMap.LatLng(31.349725, 121.508389),
new TMap.LatLng(31.359730, 121.508389),
new TMap.LatLng(31.369718, 121.518400)
];
marker.moveAlong({
//讓座標動起來
"person": {
path,
//速度爲100
speed: 100
}
}, {
autoRotation:true //車頭始終向前(沿路線自動旋轉)
}
)
}
</script>
3. 案例:使用騰訊位置服務API實現打卡功能
3.1 實現思路
3.1.1 位置搜索
接口: https://apis.map.qq.com/ws/place/v1/search 搜索上海 上海五角場地鐵站的位置 示例:https://apis.map.qq.com/ws/place/v1/search?keyword=五角場地鐵站&boundary=region(上海,0) &key=HLSBZ--
搜索結果截取: { “id”: “10804093066539767491”, “title”: “五角場[地鐵站]”, “address”: “地鐵10號線”, “tel”: “”, “category”: “基礎設施:交通設施:地鐵站”, “type”: 2, “location”: { “lat”: 31.298109, “lng”: 121.514651 }, “ad_info”: { “adcode”: 310110, “province”: “上海市”, “city”: “上海市”, “district”: “楊浦區” } }
現在知道五角場地鐵站的經緯度了,就是Location那兩個值。 注意key是創建好的這一串ID 通過搜索出來的是一個List,上述只拿出了List的第一位,通常第一位也是嘴和搜索關鍵字相符合的。通過搜索取出我們固定的經緯度的地址。
3.1.2 定位(Android定位)
單次定位,獲取當前設備位置
mLocationManager.requestSingleFreshLocation(null, mLocationListener, Looper.getMainLooper());
其他IOS等設備可以通過騰訊位置服務官方文檔查看。 獲取到位置後將該位置傳到後臺接口。
3.1.3 後臺接口
求距離:
// 寫死的公司位置,實際項目中應該是數據庫配置
private static final double COMPANY_LAT = 31.298109;
private static final double COMPANY_LNG = 121.514651;
@GetMapping("distance")
public Map<String,Double> queryDistance(Double lat,Double lng){
HashMap<String, Double> result = new HashMap<>(4);
double distance = distance(COMPANY_LAT, lat, COMPANY_LNG, lng);
result.put("distance",distance);
return result;
}
/**
* 求兩個經緯度之間的距離
*/
public static double distance(double lat1, double lat2, double lng1, double lng2) {
final int r = 6371;
double latDistance = Math.toRadians(lat2 - lat1);
double lonDistance = Math.toRadians(lng2 - lng1);
double a = Math.sin(latDistance / 2) * Math.sin(latDistance / 2)
+ Math.cos(Math.toRadians(lat1)) * Math.cos(Math.toRadians(lat2))
* Math.sin(lonDistance / 2) * Math.sin(lonDistance / 2);
double c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
double distance = r * c * 1000;
distance = Math.pow(distance, 2);
return Math.sqrt(distance);
}