#冲刺创作新星#腾讯位置服务API接入教程详解 原创

炒香菇的书呆子
发布于 2022-10-29 18:56
浏览
0收藏

@[TOC]

1 地图调起(URI API)

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

2 功能

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

3调用

3.1Web端调用

3.1.1接口调用说明

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

3.1.2方法及参数

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

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

3.1.3样例分析

https://apis.map.qq.com/uri/v1/search?keyword=酒店&region=沧州&referer=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77

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

Web浏览器打开效果

#冲刺创作新星#腾讯位置服务API接入教程详解-鸿蒙开发者社区

在手机浏览器打开示例效果
#冲刺创作新星#腾讯位置服务API接入教程详解-鸿蒙开发者社区

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时,可通过浏览器调起腾讯地图下载页,为用户提供下载,实现体验闭环。
    下载页链接:
    https://pr.map.qq.com/j/tmap/download?key=YourKey
    a. 该页面会自动区分Android 与 iOS ,并下载相应APP包;
    #冲刺创作新星#腾讯位置服务API接入教程详解-鸿蒙开发者社区

    b. YourKey:开发者Key,选填(点此申请,Key类型选择“浏览器”),用于标识开发者身份
    #冲刺创作新星#腾讯位置服务API接入教程详解-鸿蒙开发者社区

#冲刺创作新星#腾讯位置服务API接入教程详解-鸿蒙开发者社区

#冲刺创作新星#腾讯位置服务API接入教程详解-鸿蒙开发者社区
调用结果

#冲刺创作新星#腾讯位置服务API接入教程详解-鸿蒙开发者社区

4 路线规划

4.1导航和路线规划

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

4.2 功能参数表

4.2.1Android/iOS调用

参数名 必填 说明 示例
type 路线规划方式参数:公交:bus驾车drive步行:walk骑行:bike type=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 请填写开发者key referer=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

©著作权归作者所有,如需转载,请注明出处,否则将追究法律责任
分类
标签
收藏
回复
举报
回复
    相关推荐