(Translated by https://www.hiragana.jp/)
WebService API | 腾讯位置服务

せいざいとべ转至标页,请稍きさき

がいじゅつ

   提供ていきょう搜索そうさくこうのう

  • 指定してい城市じょうし/区域くいき搜索そうさく:如在北京ぺきん搜索そうさくけいてんしんぞうだか级参すう支持しじ获取车站、つくえ场、园区とう较大范围地点ちてんてきてん出入口でいりぐち热度,辅助よう户选择准确目的もくてき
  • しゅう搜索そうさく:如,搜索そうさく颐和园附きん半径はんけい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いた1000
auto_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. 筛选ゆう电话てき地点ちてん:tel<>null
搜索そうさく指定していぶん
ぶん类名:filter=category=おおやけ交车站
ぶん类编码:filter=category=271013
搜索そうさく个分类
ぶん类名:filter=category=大学だいがく,中学ちゅうがく
ぶん类编码:filter=category= 241000,241100
排除はいじょ指定していぶん
ぶん类名:filter=category<>しょう务楼宇
ぶん类编码:filter=category<>281200
注意ちゅういさんすう值要进行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-*****

ざい线体验

boundary
page_size
page_index
keyword
key请在实际请求时传にゅう您的key
apptag
はん


城市じょうし/区域くいき搜索そうさく

请求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(行政ぎょうせい划代码,せい确到县级),如130681
auto_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. 筛选ゆう电话てき地点ちてん:tel<>null
搜索そうさく指定していぶん
ぶん类名:filter=category=おおやけ交车站
ぶん类编码:filter=category=271013
搜索そうさく个分类
ぶん类名:filter=category=大学だいがく,中学ちゅうがく
ぶん类编码:filter=category= 241000,241100
排除はいじょ指定していぶん
ぶん类名:filter=category<>しょう务楼宇
ぶん类编码:filter=category<>281200
注意ちゅういさんすう值要进行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-*****


ざい线体验

boundary
page_size
page_index
keyword
filter
key请在实际请求时传にゅう您的key
apptag
はん

调用しめせれい:按城统计结果

//GET请求しめせれい注意ちゅういさんすう值要进行URL编码
https://apis.map.qq.com/ws/place/v1/search?boundary=region(全国ぜんこく)&keyword=博物はくぶつ馆&key=OB4BZ-D4W3U-*****

ざい线体验

boundary
keyword
key请在实际请求时传にゅう您的key
apptag
はん


矩形くけい范围(へいまく视野ない)搜索そうさく

请求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. 筛选ゆう电话てき地点ちてん:tel<>null
搜索そうさく指定していぶん
ぶん类名:filter=category=おおやけ交车站
ぶん类编码:filter=category=271013
搜索そうさく个分类
ぶん类名:filter=category=大学だいがく,中学ちゅうがく
ぶん类编码:filter=category= 241000,241100
排除はいじょ指定していぶん
ぶん类名:filter=category<>しょう务楼宇
ぶん类编码:filter=category<>281200
注意ちゅういさんすう值要进行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-*****

ざい线体验

boundary
page_size
page_index
keyword
key请在实际请求时传にゅう您的key
apptag
はん


边形范围搜索そうさく

ほんせっこう提供ていきょうもと于多边形范围てき地点ちてん搜索そうさく能力のうりょく
ちゅう
ほんふく务属于高级付费服务,如需试用请ひさげ交商务合作がっさく开通ふく务试よう

请求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. めん积<30平方ひらかた公里くり(引擎评估ちゅう
5. 目前もくぜん边形支持しじ支持しじまたが城市じょうし
polygon=39.932512,116.355515;39.933697,116.434650;39.913291,116.435509;39.913555,116.356201
keyword これ 搜索そうさく关键,长度最大さいだい96个字节,ちゅう:keyword仅支持しじ检索いち个。
APIさいようUTF-8编码,1个英文字もじうらないよう1个字节,1个中文字もじうらない3个字节,具体ぐたい请参阅相关技术资りょう
keyword=美食びしょく
filter いや 筛选条件じょうけん
1. 指定していぶん类筛选,语句格式かくしき为: category=ぶん类名1,ぶん类名2
ぶん类词数量すうりょうけん议不ちょう过5个,支持しじ设置ぶん类编码(支持しじてきぶん类请参考さんこう:POIぶん类表)
2. 排除はいじょ指定していぶん类,语句格式かくしき为: category<>ぶん类名1,ぶん类名2 ふん类词数量すうりょうけん议不ちょう过5个,支持しじ设置ぶん类编码(支持しじてきぶん类请参考さんこう:POIぶん类表)
搜索そうさく指定していぶん类filter=category=おおやけ交站
搜索そうさく个分类filter=category=大学だいがく,中学ちゅうがく
排除はいじょ指定していぶん类 filter=category<>しょう务楼宇
注意ちゅういさんすう值要进行url编码)
get_subpois いや かえしかい地点ちてん,如大厦停车场、出入口でいりぐちとう值:
0 [だま认]かえしかい
1 かえしかい
get_subpois=1
page_size いや まい页条すう最大限さいだいげんせい为20じょうだま认为10じょう page_size=10
page_index いや 页码,だま认第1页 page_index=1
output いや かえしかい值类がた:json、jsonp output=jsonp
callback いや かい调函すう callback=cb

响应结果

名称めいしょう

类型

必填

说明

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地点ちてんぶん

 

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ぶん别为90,如济みなもとadcode419001

 

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ぶん别为90,如济みなもとadcode419001

district

string

これ

调用しめせれい

//GET请求しめせれい注意ちゅういさんすう值要进行URL编码
https://apis.map.qq.com/ws/place/v1/search_by_polygon?polygon=39.932512,116.355515;39.933697,116.434650;39.913291,116.435509;39.913555,116.356201&keyword=おおやけ园&key=OB4BZ-D4W3U-*****

{
    "status": 0,
    "message": "Success",
    "request_id": "29b9247f970b4d7290f0f65e91a2d5af",
    "count": 109,
    "data": [
        {
            "id": "18004506485022383500",
            "title": "景山かげやまこう园",
            "address": "北京ぺきん西城にししろ景山かげやま西にしがい44ごう",
            "category": "たびゆうけいてん:国家こっか级景てん",
            "location": {
                "lat": 39.925841,
                "lng": 116.39677
            },
            "ad_info": {
                "adcode": 110102,
                "province": "北京ぺきん",
                "city": "北京ぺきん",
                "district": "西城にししろ"
            },
            "tel": "010-64044071",
            "type": 0
        },
        //其他省略しょうりゃく
        }
    ]
}

しゅう边推荐(explore)

ただ提供ていきょう搜索そうさく中心ちゅうしんてん半径はんけい(无须关键词),そく搜索そうさく获取しゅう边高热度地点ちてん
一般用于发送位置、门店签到とう场景,动为よう提供ていきょう备选地点ちてんれつひょう

请求URL

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

请求さんすう

请求方式ほうしき(Method): GET

さんすう 必填 说明 しめせれい
key これ 开发みつ钥(Key) key=OB4BZ-D4W3U-***
boundary これ 格式かくしき
boundary=nearby(lat,lng,radius[, auto_extend])
さんすう
lat,lng:搜索そうさく中心ちゅうしんてんてき经纬,纬度ざいまえ,经度ざいきさき
radius:搜索そうさく半径はんけい,单位:べい值范围:200いた1000
auto_extend:[选] とうぜん范围无结はて时,いや动扩だい范围,值:
0 扩大
1 [だま认] 动扩だい范围(按照按1公里くり、2公里くり、5公里くり最大さいだいいたぜん城市じょうし范围搜索そうさく
boundary=nearby(28.681114,115.918377,1000,1)
policy いや 搜索そうさく策略さくりゃく选值:
1 [だま认]地点ちてん签到场景,针对よう户签到てき热门 地点ちてん进行优先はいじょ
2 位置いちどもとおる场景,よう于发送位置いち位置いちぶんとおるとう场景てき热门地点ちてん优先はいじょ
policy=1
filter いや 筛选条件じょうけん支持しじ指定していぶん类筛选,语句格式かくしき为:
category=ぶん类名1,ぶん类名2
ぶん类词数量すうりょうけん议不ちょう过5个(支持しじてきぶん类请参考さんこうPOIぶん类表
搜索そうさく指定していぶん
filter=category=おおやけ交车站
ぶん类编码:filter=category=271013
搜索そうさく个分类
filter=category=大学だいがく,中学ちゅうがく
ぶん类编码:filter=category= 241000,241100
注意ちゅういさんすう值要进行url编码)
orderby いや はいじょ支持しじ按距离由ちかいた远排じょ值:_distance
说明:しゅう搜索そうさくだま认排じょかい综合こう虑距离、权重とう多方面たほうめんいんもと,而设おけ按距离排じょきさき则仅こう虑距离远きん,一些低权重的地点可能因距离近排在前面
orderby=_distance
address_format いや 格式かくしき选值:short,かえしかい包含ほうがんしょう市区しくてきたん
かけしょう则为包含ほうがんしょう市区しくてき标准
address_format=short
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 これ
category string これ POI(地点ちてんぶん
location object これ すわ
lat number これ 纬度
lng number これ 经度
_distance number これ あずかboundary传入てき经纬てき距离,单位: べい
ad_info object これ 行政ぎょうせい划信いき
adcode number これ 行政ぎょうせい划代码,详见:行政ぎょうせい划代码说あきら
province string これ しょう
city string これ ,如果とうぜん城市じょうし为省ちょく辖县级区划,cityあずかdistrictだんひとしかいかえしかい此城
ちゅうはぶけちょく辖县级区划adcodeだい3だい4ぶん别为9、0,如济みなもとadcode为419001
district string これ

调用しめせれい

//GET请求
//しゅう边推荐:boundary=nearby(lat,lng<中心ちゅうしんすわ标>,radius<半径はんけい/べい>)
https://apis.map.qq.com/ws/place/v1/explore?boundary=nearby(40.040394,116.273523,1000)&policy=1&page_size=10&page_index=1&key=OB4BZ-D4W3U-*****

ざい线体验

boundary
page_size
page_index
policy
key请在实际请求时传にゅう您的key
apptag
はん


しゅう边推荐(here)

あずかexplore相似そうじただ提供ていきょう搜索そうさく中心ちゅうしんてん半径はんけい(无须关键词),そく搜索そうさく获取しゅう边高热度地点ちてん

ただしほんせっこう侧重于以标+主要しゅようてき+きん距离POI为主,ちゃくりょく描述とうぜん位置いちどう提供ていきょういたいえ场景(如创たておさむ货地)、いでゆき场景てき地点ちてん推荐。



ほんふく务属于高级服务,如需せっにゅう在官ざいかん网工单系统ひさげ交工单さる请开どおり调用权限。

请求URL

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

请求さんすう

请求方式ほうしき(Method): GET

さんすう 必填 说明 しめせれい
key これ 开发みつ钥(Key) key=OB4BZ-D4W3U-***
boundary これ 格式かくしき
boundary=nearby(lat,lng,radius[, auto_extend])
さんすう
lat,lng:搜索そうさく中心ちゅうしんてんてき经纬,纬度ざいまえ,经度ざいきさき
radius:搜索そうさく半径はんけい,单位:べい值范围:10いた1000
boundary=nearby(28.681114,115.918377,1000)
policy いや 搜索そうさく策略さくりゃく
policy=1[だま认] 以地标+主要しゅようてき+きん距离POI为主,ちゃくりょく描述とうぜん位置いち
policy=2 いたいえ场景:筛选あい适收货的POI,并会细化おさむ货地せい确到ろう栋;
policy=3 ぎょう场景:过滤掉车辆不易ふえきいた达的POI(如一些景区内くないPOI),增加ぞうか道路どうろ出入口でいりぐち交叉こうさこうだい区域くいき出入口でいりぐち类POI,はいじょかいすえ实API大用おおゆう户的よう户点击自动优
policy=1
filter いや 筛选条件じょうけん支持しじ指定していぶん类筛选,语句格式かくしき为:
category=ぶん类名1,ぶん类名2
ぶん类词数量すうりょうけん议不ちょう过5个(支持しじてきぶん类请参考さんこうPOIぶん类表
搜索そうさく指定していぶん
filter=category=おおやけ交站
搜索そうさく个分类
filter=category=美食びしょく,购物
address_format いや 格式かくしき选值:short,かえしかい包含ほうがんしょう市区しくてきたん
かけしょう则为包含ほうがんしょう市区しくてき标准
address_format=short
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 これ
category string これ POI(地点ちてんぶん
location object これ すわ
lat number これ 纬度
lng number これ 经度
_distance number これ あずかboundary传入てき经纬てき距离,单位: べい
ad_info object これ 行政ぎょうせい划信いき
adcode number これ 行政ぎょうせい划代码,详见:行政ぎょうせい划代码说あきら
province string これ しょう
city string これ ,如果とうぜん城市じょうし为省ちょく辖县级区划,cityあずかdistrictだんひとしかいかえしかい此城
ちゅうはぶけちょく辖县级区划adcodeだい3だい4ぶん别为9、0,如济みなもとadcode为419001
district string これ

调用しめせれい

//GET请求
//しゅう边推荐:boundary=nearby(lat,lng<中心ちゅうしんすわ标>,radius<半径はんけい/べい>)
https://apis.map.qq.com/ws/place/v1/here?boundary=nearby(40.040394,116.273523,1000)&policy=1&page_size=10&page_index=1&key=OB4BZ-D4W3U-*****

ざい线体验

boundary
page_size
page_index
policy
key请在实际请求时传にゅう您的key
はん


ID查询(detail)

请求URL

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

请求さんすう

请求方式ほうしき(Method): GET

さんすう 必填 说明 しめせれい
key これ 开发みつ钥(Key) key=OB4BZ-D4W3U-*****
id これ 腾讯图POI(地点ちてんただいち标识,支持しじpoiid检索,最大さいだい支持しじ10个,よう英文えいぶん逗号ぶんへだた id=6621879543162709731
output いや かえしかい格式かくしき
支持しじJSON/JSONP,だま认JSON
output=json
callback いや JSONP方式ほうしきかい调函すう callback=function1

响应结果

名称めいしょう 类型 必有 说明
status number これ じょう态码,0为正常せいじょう,其它为异つね,详细请参阅じょう态码说明
message string これ じょう态说あきら
count number これ ほんつぎ搜索そうさく结果总数
request_id string これ ほんつぎ请求てきただいち标识,よしけい统自动生成せいせいよう于追查结はてゆう异常时使用しよう
data array これ 搜索そうさく结果POI(地点ちてんすう组,まい项为いち个POI(地点ちてん)对象
id string これ POI(地点ちてんただいち标识
title string これ POI(地点ちてん名称めいしょう
address string これ
tel string これ 电话
category string これ POI(地点ちてんぶん
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 これ /县,とうtype(POI类型)为3(おおやけ交线)时,districtゆかりcity补全

调用しめせれい

//GET请求
//查询ID为6621879543162709731てき地点ちてんしんいき
https://apis.map.qq.com/ws/place/v1/detail?id=6621879543162709731&key=OB4BZ-D4W3U-*****

ざい线体验

id
key请在实际请求时传にゅう您的key
apptag
はん


这篇文章ぶんしょう对您かい决问题是いやゆう帮助?

やめかい
かい