微信小程序JavaScript SDK | 腾讯位置服务

getCityList(options:Object)

获取全国城市列表数据。

注：坐标系采用gcj02坐标系

options属性说明

属性	类型	必填	说明
sig	String	否	签名校验开启WebServiceAPI签名校验的必传参数，只需要传入生成的SK字符串即可，不需要进行MD5加密操作该参数仅适用于 jssdkv1.2

调用结果

通过属性success, fail, complete的回调参数来接收调用结果

success的回调参数可以有2个，第1个参数接收调用结果，第2个参数控制返回处理后的数据（非必须参数）,示例：success:function(res,data)
该属性适用于 jssdkv1.1 jssdkv1.2

名称			类型	必有	说明
status			number	是	状态码，0为正常, 310请求参数信息有误， 311key格式错误, 306请求有护持信息请检查字符串, 110请求来源未被授权
message			string	是	状态说明，即对状态码status进行说明，如： status为0,message为"query ok",为正常, status为310,message为"请求参数信息有误", status为311,message为"key格式错误", status为306,message为"请求有护持信息请检查字符串", status为110,message为"请求来源未被授权"
result			array	是	结果数组，第0项，代表一级行政区划，第1项代表二级行政区划，以此类推；使用getchildren接口时，仅为指定父级行政区划的子级
	id		number	是	行政区划唯一标识
	name		string	-	简称，如“内蒙古”
	fullname		string	是	全称，如“内蒙古自治区”
	location		string	是	中心点坐标
		lat	number	是	纬度
		lng	number	是	经度
	pinyin		array	-	行政区划拼音，每一下标为一个字的全拼，如：["nei","meng","gu"]
	cidx		array	-	子级行政区划在下级数组中的下标位置

示例

Javascript 关键代码片段：

// 引入SDK核心类
                        var QQMapWX = require('xxx/qqmap-wx.js');

// 实例化API核心类
                        var qqmapsdk = new QQMapWX({
                            key: '开发密钥（key）' // 必填
                        });

//在Page({})中使用下列代码
                        //页面显示/切入前台时触发
                        onShow: function() {
                            var _this = this;
                            //调用获取城市列表接口
                            qqmapsdk.getCityList({
                              success: function(res) {//成功后的回调
                                console.log(res);
                                console.log('省份数据：', res.result[0]); //打印省份数据
                                console.log('城市数据：', res.result[1]); //打印城市数据
                                console.log('区县数据：', res.result[2]); //打印区县数据
                              },
                              fail: function(error) {
                                console.error(error);
                              },
                              complete: function(res) {
                                console.log(res);
                              }
                            });
                        }

接口调用说明

getCityList(options:Object)方法调用接口服务如下：

/ws/district/v1/list 行政区划:列表

超过日调用量和并发数的开发者，可通过以下途径解决：
     1. 对于多频次的相同请求，可通过缓存结果，并定时访问更新的方式，减少对在线服务调用的依赖；
     2. 企业开发者的配额高于个人开发者，申请企业认证后，需要在控制台->配额申请中免费申请你需要的配额。
        我们将对您的申请进行评估并进行审批（3个工作日内），审批通过后将会获得您申请的配额。
     3. 对于切实需要大配额来满足应用需求的，请在控制台->配额管理中提交购买配额申请，我们的商务会与您取得联系。