腾讯位置商业授权微信小程序获取城市列表

微信小程序JavaScript SDK

开发指南

获取城市列表

getCityList(options:Object)

获取全国城市列表数据。

注:坐标系采用gcj02坐标系

options属性说明

属性 类型 必填 说明
sig String 签名校验 开启WebServiceAPI签名校验的必传参数,只需要传入生成的SK字符串即可,不需要进行MD5加密操作 该参数适用于 jssdkv1.1 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 行政区划:列表

注:微信小程序JavaScript SDK通过对腾讯位置服务WebServiceAPI接口进行封装而形成,因此和直接调用WebSerivceAPI的限制是等同的,

具体可参考:腾讯位置服务WebServiceAPI配额及使用限制

资料来源:

腾讯位置商业授权微信小程序获取城市列表-腾讯地图代理商

相关推荐
大模型真好玩4 小时前
深入浅出LangGraph AI Agent智能体开发教程(三)—LangGraph工具调用实战
人工智能·python·mcp
高级测试工程师欧阳5 小时前
SQLint3 模块如何使用
数据库·python·mysql·oracle
LeonDL1685 小时前
【通用视觉框架】基于Python+OpenCV+PyQt5开发的视觉框架软件,全套源码,开箱即用
图像处理·人工智能·python·opencv·pyqt5·通用视觉框架软件·机器视觉软件框架
摘星编程5 小时前
Cursor 辅助开发:快速搭建 Flask + Vue 全栈 Demo 的实战记录
vue.js·python·flask·cursor·ai辅助编程
图灵信徒5 小时前
ICPC Central Russia Regional Contest, 2024
c++·python·codeforces·算法竞赛
UrbanJazzerati5 小时前
Excel自动化实战:使用Python实现Salesforce Flow翻译版本同步
python·面试
0wioiw05 小时前
Python基础(①③GIL全局解释器锁)
开发语言·python
CH3_CH2_CHO5 小时前
DAY02:【DL 第一弹】pytorch
人工智能·pytorch·python·深度学习·回归
Brown.alexis6 小时前
处理省市区excel数据加工成SQL
python·sql·excel