腾讯位置服务API接入教程详解

1,377 阅读4分钟

携手创作,共同成长!这是我参与「掘金日新计划 · 8 月更文挑战」的第35天,点击查看活动详情

@[TOC]

1 地图调起(URI API)

:URI API是一组用于打开腾讯地图网站或者打开用户手机上安装的腾讯地图产品的协议接口,一般在第三方网站或应用中需要用到地图相关的功能时,可以通过这套接口启动腾讯地图产品的不同功能模块,为用户提供地图及导航服务。

2 功能

:周边地点搜索、公交搜索、路线导航、逆地址解析、地点标注、街景展示 适用开发平台: 面向浏览器:WebPC版腾讯地图、移动端浏览器H5版腾讯地图 面向移动端APP:Android版腾讯地图、iOS版腾讯地图

3调用

3.1Web端调用

3.1.1接口调用说明

一次完整的URI调用需要包含两部分信息:引用地址、方法及参数 指定启用的腾讯地图产品类型 Web/Wap版地图:apis.map.qq.com/uri/v1/

3.1.2方法及参数

指定启用的功能及该功能需要设定的参数。格式:method?param=value[&param=value&…]

其中method是方法名,具体支持的方法有:search,地点/公交搜索,周边搜索;routeplan,路线规划,包括公交、驾车;geocoder,逆地址解析;marker,地点标注;streetview,街景展示。

3.1.3样例分析

apis.map.qq.com/uri/v1/sear…

说明:apis.map.qq.com/uri/v1/ 是引用地址,search是方法名,keyword、region、referer是参数名。

Web浏览器打开效果

在这里插入图片描述

在手机浏览器打开示例效果 在这里插入图片描述

3.2 Android/iOS调用

  1. 接口调用说明 适用于在手机端APP 和 手机浏览器中,调起腾讯地图APP。 iOS通过scheme调用,Android使用Intent调用,统一协议为:qqmap://map/ 、直接调用系统的canOpenURL进行判断

  2. APP判断手机中是否安装腾讯地图 Android系统:请检测包名 com.tencent.map iOS系统:腾讯地图的URLSheme 是qqmap:// ,直接调用系统的canOpenURL进行判断

  3. 手机中未安装腾讯地图APP的处理方式 打开腾讯地图下载页 当用户手机中未安装腾讯地图APP时,可通过浏览器调起腾讯地图下载页,为用户提供下载,实现体验闭环。 下载页链接: pr.map.qq.com/j/tmap/down… a. 该页面会自动区分Android 与 iOS ,并下载相应APP包; 在这里插入图片描述

    b. YourKey:开发者Key,选填(点此申请,Key类型选择“浏览器”),用于标识开发者身份 在这里插入图片描述

在这里插入图片描述

在这里插入图片描述 调用结果

在这里插入图片描述

4 路线规划

4.1导航和路线规划

根据指定起点、终点以及出行方式,调起腾讯地图APP的路线规划功能,查询出行路线,并在地图中展示。 Android 和 iOS 调用地址qqmap://map/routeplan

4.2 功能参数表

4.2.1Android/iOS调用

参数名必填说明示例
type路线规划方式参数:公交:bus驾车drive步行:walk骑行:biketype=bus 或 type=drive 或 type=walk 或 type=bike
from起点名称from=鼓楼
fromcoord起点坐标,格式:lat,lng (纬度在前,经度在后,逗号分隔)功能参数值:CurrentLocation :使用定位点作为起点坐标fromcoord=39.907380,116.388501fromcoord=CurrentLocation
to终点名称to=奥林匹克森林公园
tocoord终点坐标tocoord=40.010024,116.392239
referer请填写开发者keyreferer=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77调用示例
测试样例
调起腾讯地图APP,显示由中国石油大学到天安门的驾车路线
qqmap://map/routeplan?type=drive&from=中国石油大学&fromcoord=39.994745,116.247282&to=天安门&tocoord=39.867192,116.493187&referer=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77

4.2.2Web端(PC/H5)调用调用

根据指定的搜索词,及搜索范围等参数,调起腾讯地图产品的搜索功能,发起地点、地址、公交搜索,并直接在地图上展示搜索结果。

注意:这里的公交搜索是指公交线搜索。例如搜索110路的信息。如果要进行公交换乘方案搜索,请使用路线规划接口。 方法名:search

参数名必填说明示例
region限定搜索城市region=北京
bound限定搜索坐标范围:矩形范围区域,参数需给定矩形 左下(西南) 和 右上(东北) 位置坐标lat,lng <左下角>,lat,lng <右上角>bound=39.907293,116.368935,39.914996,116.372
coord_type坐标类型,取值如下: 1. GPS 2. 腾讯坐标(默认)如果用户指定该参数为非腾讯地图坐标系,则URI API自动进行坐标处理,以便准确对应到腾讯地图底图上。coord_type=1