微信小程序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. 对于切きり实需要じゅよう大だい配はい额来满足应用需求的てき，请在控ひかえ制せい台だい->配はい额管理かんり中ちゅう提ひさげ交购买配额申请，我わが们的商しょう务会与あずか您取得しゅとく联系。