设为首页收藏本站
开启辅助访问
WebService API 您所在的位置：网站首页 › 经度纬度搜索 › WebService API

WebService API

2024-05-17 17:56| 来源: 网络整理| 查看: 265

正在跳转至目标页，请稍后…

概述

   提供多种搜索功能：

指定城市/区域搜索：如在北京搜索景点。新增高级参数：支持获取车站、机场、园区等较大范围地点的子点和出入口热度，辅助用户选择准确目的地。 周边搜索：如，搜索颐和园附近半径500米内的酒店（一个圆形范围）； 矩形范围搜索：在地图应用中，往往用于视野内搜索，因为显示地图的区域是个矩形。 多边形范围搜索：自定义多边形范围进行地点搜索，由此您可以更好地控制搜索范围的准确性。 周边推荐：只需提供中心点及半径（无须关键词），即可搜索获取周边高热度地点，一般用于发送位置、地点签到等场景，自动为用户提供备选地点列表 id查询POI信息：通过POI ID查询POI信息 周边搜索

请求URL

https://apis.map.qq.com/ws/place/v1/search

请求参数

请求方式（Method）： GET

参数 必填 说明 示例 key 是 开发密钥（Key） key=OB4BZ-D4W3U-*** keyword 是 搜索关键字，长度最大96个字节，注：keyword仅支持检索一个。（API采用UTF-8字符编码，1个英文字符占用1个字节，1个中文字符占3个字节，具体请参阅相关技术资料） keyword=酒店，注意键值要进行URL编码（推荐encodeURI），如keyword=%e9%85%92%e5%ba%97 boundary 是 格式：boundary=nearby(lat,lng,radius[, auto_extend])子参数：lat,lng：搜索中心点的经纬度，格式顺序为纬度在前，经度在后radius：搜索半径，单位：米，取值范围：10到1000auto_extend：[可选] 当前范围无结果时，是否自动扩大范围，取值： 0 不扩大 1 [默认] 自动扩大范围（依次按照按1公里、2公里、5公里， 最大到全城市范围搜索） boundary=nearby(28.681114,115.918377,1000,1) get_subpois 否 是否返回子地点，如大厦停车场、出入口等取值：0 [默认]不返回1 返回 get_subpois=1 filter 否 筛选条件1. 指定分类筛选，语句格式为： category=分类名1,分类名2 分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表）2. 排除指定分类，语句格式为： category分类名1,分类名2 分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表）3. 筛选有电话的地点：telnull 搜索指定分类分类名：filter=category=公交车站 分类编码：filter=category=271013 搜索多个分类分类名：filter=category=大学,中学 分类编码：filter=category= 241000,241100 排除指定分类分类名：filter=category商务楼宇 分类编码：filter=category281200 （注意参数值要进行url编码） added_fields 否 返回指定标准附加字段，取值支持：category_code - poi分类编码 added_fields=category_code orderby 否 排序，支持按距离由近到远排序，取值：_distance说明：1. 周边搜索默认排序会综合考虑距离、权重等多方面因素2. 设置按距离排序后则仅考虑距离远近，一些低权重的地点可能因距离近排在前面，导致体验下降 orderby=_distance page_size 否 每页条目数，最大限制为20条，默认为10条 page_size=10 page_index 否 第x页，默认第1页 page_index=2 output 否 返回格式：支持JSON/JSONP，默认JSON output=json callback 否 JSONP方式回调函数 callback=function1 响应结果 名称 类型 必有 说明 status number 是 状态码，0为正常，其它为异常，详细请参阅状态码说明 message string 是 状态说明 count number 是 本次搜索结果总数，另外本服务限制最多返回200条数据(data)，翻页（page_index）超过搜索结果总数返回空，未超过搜索总数但超过200条限制时，将返回最后一页数据。 request_id string 是 本次请求的唯一标识，由系统自动生成，用于追查结果有异常时使用 data array 是 搜索结果POI（地点）数组，每项为一个POI（地点）对象 id string 是 POI（地点）唯一标识 title string 是 POI（地点）名称 address string 是 地址 tel string 是 电话 category string 是 POI（地点）分类 category_code number 否 POI（地点）分类编码，设置added_fields=category_code时返回 type number 是 POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划 location object 是 坐标 lat number 是 纬度 lng number 是 经度 _distance number 是 距离，单位： 米，在周边搜索、城市范围搜索传入定位点时返回 ad_info object 是 行政区划信息 adcode number 是 行政区划代码，详见：行政区划代码说明 province string 是 省 city string 是 市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001 district string 是 区 sub_pois array 否 子地点列表，仅在输入参数get_subpois=1时返回 parent_id string 是 主地点ID，对应data中的地点ID id string 是 地点唯一标识 title string 是 地点名称 tel string 是 电话 category string 是 POI（地点）分类 type number 是 POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划 address string 是 地址 location object 是 坐标 lat number 是 纬度 lng number 是 经度 ad_info object 是 行政区划信息 adcode number 是 行政区划代码，详见：行政区划代码说明 province string 是 省 city string 是 市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001 district string 是 区 调用示例

//GET请求示例，注意参数值要进行URL编码 //周边搜索（圆形范围）：boundary=nearby(lat,lng,radius)https://apis.map.qq.com/ws/place/v1/search?boundary=nearby(40.040589,116.273543,1000)&keyword=公园&page_size=10&page_index=1&key=OB4BZ-D4W3U-*****

在线体验

城市/区域搜索

请求URL

https://apis.map.qq.com/ws/place/v1/search

请求参数

请求方式（Method）： GET

参数 必填 说明 示例 key 是 开发密钥（Key） key=OB4BZ-D4W3U-*** keyword 是 搜索关键字，长度最大96个字节，注：keyword仅支持检索一个。（API采用UTF-8字符编码，1个英文字符占用1个字节，1个中文字符占3个字节，具体请参阅相关技术资料） keyword=酒店，注意键值要进行URL编码（推荐encodeURI），如keyword=%e9%85%92%e5%ba%97 boundary 是 格式：boundary=region(city_name [,auto_extend][,lat,lng])子参数：city_name：检索城市名称， 如北京市，同时支持adcode（行政区划代码，可精确到区县级），如130681auto_extend：[可选]当前范围无结果时，是否自动扩大范围，取值 0 仅在当前城市搜索； 1 [默认] 若当前城市搜索无结果，则自动扩大范围； 2 限制在当前区/县范围搜索，无结果时不自动扩大范围（仅在传入city_name为区级或区级行政区划代码时有效）。 lat,lng：[可选] 当keyword使用酒店、超市等泛分类关键词时，这类场景大多倾向于搜索附近，传入此经纬度，搜索结果会优先就近地点，体验更优。格式顺序为纬度在前，经度在后 boundary=region(北京,1,40.040493,116.273545) get_subpois 否 是否返回子地点，如大厦停车场、出入口等取值：0 [默认]不返回1 返回 get_subpois=1 返回子点热度 否 支持获取车站、机场、园区等较大范围地点的子点和出入口热度，辅助用户选择准确目的地。本参数属于高级付费参数，如需试用请提交商务合作开通试用。 filter 否 筛选条件1. 指定分类筛选，语句格式为： category=分类名1,分类名2 分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表）2. 排除指定分类，语句格式为： category分类名1,分类名2 分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表）3. 筛选有电话的地点：telnull 搜索指定分类分类名：filter=category=公交车站 分类编码：filter=category=271013 搜索多个分类分类名：filter=category=大学,中学 分类编码：filter=category= 241000,241100 排除指定分类分类名：filter=category商务楼宇 分类编码：filter=category281200 （注意参数值要进行url编码） added_fields 否 返回指定标准附加字段，取值支持：category_code - poi分类编码 added_fields=category_code page_size 否 每页条目数，最大限制为20条，默认为10条 page_size=10 page_index 否 第x页，默认第1页 page_index=2 output 否 返回格式：支持JSON/JSONP，默认JSON output=json callback 否 JSONP方式回调函数 callback=function1 响应结果 - 正常搜索结果 名称 类型 必有 说明 status number 是 状态码，0为正常，其它为异常，详细请参阅状态码说明 message string 是 状态说明 count number 是 本次搜索结果总数，另外本服务限制最多返回200条数据(data)，翻页（page_index）超过搜索结果总数返回空，未超过搜索总数但超过200条限制时，将返回最后一页数据。 request_id string 是 本次请求的唯一标识，由系统自动生成，用于追查结果有异常时使用 data array 是 搜索结果POI（地点）数组，每项为一个POI（地点）对象 id string 是 POI（地点）唯一标识 title string 是 POI（地点）名称 address string 是 地址 tel string 是 电话 category string 是 POI（地点）分类 category_code number 否 POI（地点）分类编码，设置added_fields=category_code时返回 type number 是 POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划 location object 是 坐标 lat number 是 纬度 lng number 是 经度 _distance number 是 距离，单位： 米，在周边搜索、城市范围搜索传入定位点时返回 ad_info object 是 行政区划信息 adcode number 是 行政区划代码，详见：行政区划代码说明 province string 是 省 city string 是 市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001 district string 是 区 sub_pois array 否 子地点列表，仅在输入参数get_subpois=1时返回 parent_id string 是 主地点ID，对应data中的地点ID id string 是 地点唯一标识 title string 是 地点名称 tel string 是 电话 category string 是 POI（地点）分类 type number 是 POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划 address string 是 地址 location object 是 坐标 lat number 是 纬度 lng number 是 经度 ad_info object 是 行政区划信息 adcode number 是 行政区划代码，详见：行政区划代码说明 province string 是 省 city string 是 市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001 district string 是 区 lines array 否 搜索公交线路数组，每项为一个公交路线对象 id string 否 公交线路唯一标识 title string 否 公交线路名称 origin object 否 当前公交线路的始发站 title string 否 始发站站点名称 destination object 否 当前公交线路的终点站 title string 否 终点站站点名称 region object 是 POI数据所属地区 title string 是 所属地区名称 响应结果 - 按城市统计结果

      当搜索范围过大，如 boundary=region(全国) 时，而且keyword的搜索结果在各城市无明显权重特别高的时，将返回各城市搜索结果数量的统计数，您可以将此统计结果展示给用户，供用户缩小城市范围，再次发起搜索使用。

名称 类型 必有 说明 status number 是 状态码，0为正常，其它为异常，详细请参阅状态码说明 message string 是 状态说明 count number 是 本次搜索结果总数 request_id string 是 本次请求的唯一标识，由系统自动生成，用于追查结果有异常时使用 data array 是 搜索结果POI（地点）数组，每项为一个POI（地点）对象 cluster array 是 统计结果数组 title string 是 城市名称 count number 是 根据搜索条件，在该城市搜到的结果数 调用示例：正常搜索结果

//GET请求示例，注意参数值要进行URL编码 //指定地区名称，不自动扩大范围：boundary=region(北京,0) https://apis.map.qq.com/ws/place/v1/search?boundary=region(北京,0)&keyword=颐和园&page_size=20&page_index=1&key=OB4BZ-D4W3U-*****

在线体验

调用示例：按城市统计结果

//GET请求示例，注意参数值要进行URL编码 https://apis.map.qq.com/ws/place/v1/search?boundary=region(全国)&keyword=博物馆&key=OB4BZ-D4W3U-*****

在线体验

矩形范围(屏幕视野内)搜索

请求URL

https://apis.map.qq.com/ws/place/v1/search

请求参数

请求方式（Method）： GET

参数 必填 说明 示例 key 是 开发密钥（Key） key=OB4BZ-D4W3U-*** keyword 是 搜索关键字，长度最大96个字节，注：keyword仅支持检索一个。（API采用UTF-8字符编码，1个英文字符占用1个字节，1个中文字符占3个字节，具体请参阅相关技术资料） keyword=酒店，注意键值要进行URL编码（推荐encodeURI），如keyword=%e9%85%92%e5%ba%97 boundary 是 格式：boundary=rectangle(lat,lng,lat,lng)子参数：由矩形左下角（西南）和右上角（东北）两对经纬度组成，格式顺序为纬度在前，经度在后 boundary=rectangle(40.037961,116.267921,40.051036,116.284873) filter 否 筛选条件1. 指定分类筛选，语句格式为： category=分类名1,分类名2 分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表）2. 排除指定分类，语句格式为： category分类名1,分类名2 分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表）3. 筛选有电话的地点：telnull 搜索指定分类分类名：filter=category=公交车站 分类编码：filter=category=271013 搜索多个分类分类名：filter=category=大学,中学 分类编码：filter=category= 241000,241100 排除指定分类分类名：filter=category商务楼宇 分类编码：filter=category281200 （注意参数值要进行url编码） added_fields 否 返回指定标准附加字段，取值支持：category_code - poi分类编码 added_fields=category_code page_size 否 每页条目数，最大限制为20条，默认为10条 page_size=10 page_index 否 第x页，默认第1页 page_index=2 output 否 返回格式：支持JSON/JSONP，默认JSON output=json callback 否 JSONP方式回调函数 callback=function1 响应结果 名称 类型 必有 说明 status number 是 状态码，0为正常，其它为异常，详细请参阅状态码说明 message string 是 状态说明 count number 是 本次搜索结果总数，另外本服务限制最多返回200条数据(data)，翻页（page_index）超过搜索结果总数返回空，未超过搜索总数但超过200条限制时，将返回最后一页数据。 request_id string 是 本次请求的唯一标识，由系统自动生成，用于追查结果有异常时使用 data array 是 搜索结果POI（地点）数组，每项为一个POI（地点）对象 id string 是 POI（地点）唯一标识 title string 是 POI（地点）名称 address string 是 地址 tel string 是 电话 category string 是 POI（地点）分类 category_code number 否 POI（地点）分类编码，设置added_fields=category_code时返回 type number 是 POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划 location object 是 坐标 lat number 是 纬度 lng number 是 经度 ad_info object 是 行政区划信息 adcode number 是 行政区划代码，详见：行政区划代码说明 province string 是 省 city string 是 市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001 district string 是 区 调用示例

//GET请求示例，注意参数值要进行URL编码 //矩形区域范围：boundary=rectangle(lat,lng, lat,lng)https://apis.map.qq.com/ws/place/v1/search?boundary=rectangle(39.907293,116.368935,39.914996,116.379321)&keyword=美食&page_size=10&page_index=1&key=OB4BZ-D4W3U-*****

在线体验

多边形范围搜索

本接口提供基于多边形范围的地点搜索能力。 注： 本服务属于高级付费服务，如需试用请提交商务合作开通服务试用。

请求URL

https://apis.map.qq.com/ws/place/v1/search_by_polygon

请求参数

请求方式（Method）： GET

参数 必填 说明 示例 key 是 开发key：您可在控制台Key管理界面自行创建，且需要开启WebServiceAPI功能 key=OB4BZ-D4W3U-*** polygon 是 多边形区域：1. 格式为lat,lng;lat,lng…2. 支持凸多边形及凹多边形，多边形不可自相交4. 面积


【本文地址】

公司简介

联系我们

今日新闻

    推荐新闻

      专题文章
        CopyRight 2018-2019 实验室设备网 版权所有