@[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浏览器打开效果

在手机浏览器打开示例效果

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包；
   

   b. YourKey：开发者Key，选填（点此申请，Key类型选择“浏览器”），用于标识开发者身份
   

调用结果

4 路线规划

4.1导航和路线规划

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

4.2 功能参数表

4.2.1Android/iOS调用

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

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

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