小程序腾讯地图海外服务接口文档（webService）

腾讯位置服务 - 海外WebserviceAPI 文档

简介

腾讯地图 Webservice API 是基于 HTTPS 协议的数据接口，开发者可以使用任何客户端、服务器和开发语言，按照腾讯地图 Webserice API 规范，按需构建 https 请求，并获取结果数据（目前支持 json/jsonp 方式返回）。

使用限制

1、 开发接入前，请通过腾讯位置服务官网申请开发者密钥（Key）：申请密钥。

 

2、 海外位置服务功能，使用前须向腾讯位置服务申请，必须将开发者 key 告知腾讯方，由腾讯方确认开通后方可使用。

3、 测试流量限额：QPS 配额≤5 次；日流量限制≤3000 次。

 

 

关于坐标系

海外位置服务采用 WGS84 坐标系

国内国外服务调用区分说明

腾讯海外位置服务的接口与国内外是一致的，那么如何区分发出的请求是调用了国内还是海外呢？   我们通过以下方法：

1. 参数 location：在周边搜索、逆地址解析等接口中作为必填的输入参数，当 location 坐标在海外时，会调用海外服务；
2. 参数 oversea：海外服务的开关，输入参数中没有 location 参数的接口（如地址解析），将通过 oversea

参数设置来判断调用国内还是海外。

特别说明

1、 地图展示:

 

1. 1. 开放 SDK 产品，下载地址：http://lbs.qq.com/android_v1/index.html http://lbs.qq.com/ios_v

 

1/index.html

 

2）开放 JSAPI 产品，调用地址：http://lbs.qq.com/javascript_v2/guide-start.html

 

注：日本不支持海外地图展示。

 

2、 海外定位能力需集成定位 SDK，下载地址：http://lbs.qq.com/geo/index.html

 

3、 目前 WebserviceAPI 全部接口暂不支持日本，suggestion 接口暂不支持日本和韩国

1. 地址解析

请求的 URL

 

https://apis.map.qq.com/ws/geocoder/v1?address= //get 请求
注：该接口不支持日本。

 

注：该接口不支持日本。

请求参数

参数	必填	说明	示列
key	是	开发密钥（Key）	key=OB4BZ-D4W3U-B7VVO-4PJW
address	是	需要解析的地址	address=200SMathildaSunyvaleCA
oversea	是	是否调用海外：   [默认]会调用国内接口   会调用海外接口	oversea=1

 

country	否	指定调用国家 如果解析的是韩国地址时需要填 korea 其它情况不用填	country=Korea
language	否	返回结果的语言： cn [默认]中文 en 英文	language=cn
output	否	返回格式：支持 JSON/JSONP，默认JSON	output=json
callback	否	JSONP 方式回调函数	callback=function1

 

响应结果

名称			类型	必有	说明
status			number	是	状态码，0 为正常
message			string	是	状态说明
result			object	是	地址解析结果
	location		string	是	解析到的坐标,经度和纬度
		lat	number	是	纬度
		lng	number	是	经度
	address_components		object	是	解析后的地址描述
		nation	string	是	国家
		ad_level_1	string	是	一级行政区划
		ad_level_2	string	-	二级
		ad_level_3	string	-	三级
		ad_level_4	string	-	四级
		street	string	-	街道
		street_number	string	-	门牌号
	reliability		number	是	可信度参考：值范围 1<低可信> - 10<

高可信>

 

调用示例

//Get 请求注意参数需要进行 URL 编码

apis.map.qq.com/ws/geocoder/v1?address=Daemyeong-ro,Nam-gu,Daegu,SouthKorea&key=API_KEY&oversea=1&country=ko rea&language=en

 

响应结果示例

{
"status": 0, "message": "query ok", "result": {
"location": {
"lat": 35.8387985, //纬度
"lng": 128.5625458 //经度
},
"address": "Daemyeong-ro, Nam-gu, Daegu, South Korea",//地址描述"address_component": {
"nation": "KOR",
"ad_level_1": "Daegu", // 一级行政区划"ad_level_2": "Daegu", // 二级"ad_level_3": "Nam-gu", // 三级"ad_level_4": "Daemyeong-dong", // 四级"street": "Daemyeong-ro", //街道"street_number": "" //门牌号
},
"reliability": 10 //可信程度
}
}

逆地址解析

请求的 URL

https://apis.map.qq.com/ws/geocoder/v1?location= // get 请 求
注：该接口不支持日本。

 

请求参数

 

参数	必填	说明	示列
key	是	开发密钥（Key）	key=OB4BZ-D4W3U-B7VVO-4PJW
location	是	需要解析的经纬度（需为国外）	location=41.8840047,-87.630220
language	否	返回结果的语言： cn [默认]中文 en 英文	language=en
Output	否	返回格式：支持 JSON/JSONP，默认JSON	output=json
callback	否	JSONP 方式回调函数	callback=function1

（注：日本以外中文支持并不完整，部分字段有中文翻译，如果需要体验一致性推荐使用英文）

响应结果

 

名称			类型	必有	说明
status			number	是	状态码，0 为正常
message			string	是	状态说明
result			object	是	逆地址解析结果
	location		object	是	坐标
		lat	number	是	纬度
		lng	number	是	经度
	address_component		object	是	地址部件，address 不满足需求时可自行拼接
		nation	string	是	国家