小程序
取消
开发
中文
EN
取消
  • 指南

    • # 添加地点

    调试诊断

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

    接口英文名：addNearbyPoi

    该接口用于添加附近小程序的地点。

    # 1. 调用方式

    # HTTPS 调用

    POST https://api.weixin.qq.com/wxa/addnearbypoi?access_token=ACCESS_TOKEN

    # 云调用

    • 调用方法：nearbyPoi.add

    • 出入参和 HTTPS 调用相同，调用方式可查看 云调用 说明文档

    # 第三方调用

    • 本接口支持第三方平台代商家调用。

    • 该接口所属的权限集 id 为：37

    • 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

    # 2. 请求参数

    # 查询参数 Query String parameters

    参数名类型必填说明
    access_tokenstring是接口调用凭证，可使用 access_token、authorizer_access_token

    # 请求体 Request Payload

    参数名类型必填说明
    kf_infostring是客服信息 选填，可自定义服务头像与昵称，具体填写字段见下方示例kf_info pic_list是字符串，内容是一个json
    pic_liststring是门店图片，最多9张，最少1张，上传门店图片如门店外景、环境设施、商品服务等，图片将展示在微信客户端的门店页。图片链接通过文档https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1444738729中的《上传图文消息内的图片获取URL》接口获取。必填，文件格式为bmp、png、jpeg、jpg或gif，大小不超过5M pic_list是字符串，内容是一个json
    service_infosstring是必服务标签列表 必填，需要填写 1、 服务标签ID 2、 服务类型tpye 3、 服务名称name 详细字段格式见下方《服务标签id编号、类型与服务名称表》 4、 APPID 5、 对应服务落地页的path路径：path路径页面要与对应的服务标签一致，例如选取外卖服务，path路径应该是小程序的外卖对应的那个页面，path路径获取咨询开发或者到小程序管理后台-工具-生成小程序码页面获取 6、新增服务描述desc：描述服务内容，例如满减、折扣等优惠信息或新品、爆品等商品信息，仅标准服务都可添加，10个字符以内。 service_infos是字符串，内容是一个json
    store_namestring是门店名字 必填，门店名称需按照所选地理位置自动拉取腾讯地图门店名称，不可修改，如需修改请重现选择地图地点或重新创建地点。
    contract_phonestring是门店电话
    hourstring是营业时间，格式11:11-12:12
    company_namestring是主体名字
    credentialstring是资质号, 15位营业执照注册号或9位组织机构代码
    addressstring是地址
    qualification_liststring是证明材料 必填 如果company_name和该小程序主体不一致，需要填qualification_list，详细规则见附近的小程序使用指南-如何证明门店的经营主体跟公众号或小程序帐号主体相关http://kf.qq.com/faq/170401MbUnim17040122m2qY.html
    is_comm_nearbystring是必填,写死为"1"
    poi_idstring是如果创建新的门店，poi_id字段为空 如果更新门店，poi_id参数则填对应门店的poi_id 选填
    map_poi_idstring是对应《在腾讯地图中搜索门店》中的sosomap_poi_uid字段 腾讯地图那边有些数据不一致，如果不填map_poi_id的话，小概率会提交失败！ 注： poi_id与map_poi_id关系： map_poi_id是腾讯地图对于poi的唯一标识 poi_id是门店进驻附近后的门店唯一标识

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber-
    errmsgstring-
    dataobject附近小程序的数据

    # Res.data Object Payload

    附近小程序的数据

    参数名类型说明
    audit_idnumber审核单 ID
    poi_idnumber附近地点 ID
    related_credentialstring经营资质证件号

    # 4. 注意事项

    • 添加请求暂不支持并发调用，建议使用时间隔1s进行串行调用

    # 5. 代码示例

    请求示例

    {
  "is_comm_nearby": 1,
  "pic_list": "{\"list\":[\"http://mmbiz.qpic.cn/mmbiz_jpg/xdtQKcpj6RuwiafT12xxxxxxxxxibSVYicfUicy2fRqiacjriatWVZPeZsVlI0eztm5Mzjfdy4wcQVicscfapoqlzQ2g/0\"]}",
  "store_name": "xxx黄焖鸡米饭(xxxx店)",
  "hour": "00:00-23:59",
  "credential": "92321324MA24xxxxxxx",
  "address": "江苏省宿迁市泗洪县尚城府邸xxxxxxxx",
  "company_name": "xxxx县阿庆小吃部",
  "service_infos": "{\"service_infos\":[{\"id\":\"1\",\"type\":\"1\",\"name\":\"外卖\",\"appid\":\"wx4e96615821xxxxxx\",\"path\":\"/pages/index/store/store?scene=148897\"}]}",
  "qualification_list": "rNdNSNGaFDIGsyhucEPyANpW9_OIMa9iXSh-CdEXqL8pkqxxxxxx",
  "kf_info": "{\"open_kf\":false}",
  "contract_phone": "18071xxxxxx",
  "map_poi_id": "30323090226254xxxxx"
}

    返回示例

    {
  "errcode": 0,
  "errmsg": "ok",
  "data": {
    "audit_id": 416620525,
    "poi_id": 112333
  }
}

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

    错误码错误描述解决方案
    40001invalid credential  access_token isinvalid or not latest获取 access_token 时 AppSecret 错误，或者 access_token 无效。请开发者认真比对 AppSecret 的正确性，或查看是否正在为恰当的公众号调用接口

    # 7. 适用范围

    本接口支持「小程序」账号类型调用。其他账号类型如无特殊说明，均不可调用。