基本说明：
| 接口地址：https://way.jd.com/huoxin/here |
|---|
| 返回格式：json |
| 请求方式：get/post |
| 请求示例：https://way.jd.com/huoxin/here?lat=39.9928&lng=116.3961&cst=1&appkey=您申请的APPKEY |
请求参数说明：
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appkey | sting | 必填 | 该平台的appkey 扫码关注公众号 |
| lat | float | 必填 | 纬度 |
| lng | float | 必填 | 经度 |
| cst | float | 必填 | 坐标系代号 |
返回参数说明：
| 名称 | 类型 | 说明 |
|---|---|---|
| code | string | 状态码 |
| charge | boolean | 是否扣费 |
| msg | string | 状态消息 |
| result | object | 数据查询结果 |
JSON返回示例：
{
"code": "10000",
"charge": false,
"msg": "查询成功",
"result": [{
"ID": "8d46626c61587c5ac57326db48f1d61d",
"DistrictName": "中国",
"TypeName": "国家"
}, {
"ID": "bb33e0e0545c9ae7db043d499b59b518",
"DistrictName": "北京市",
"TypeName": "市"
}, {
"ID": "b11e7c26cf082d3b34908c071f7a2e65",
"DistrictName": "朝阳区",
"TypeName": "区县"
}, {
"ID": "4597ce91c5eb32b952ab87b24b802ba4",
"DistrictName": "国家体育场",
"TypeName": "体育场馆"
}]
}
服务级错误码参照
| 错误码 | 说明 |
|---|---|
| 10001 | 错误的请求appkey |
| 11010 | 商家接口调用异常，请稍后再试 |
| 11030 | 商家接口返回格式有误 |
| 10003 | 不存在相应的数据信息 |
| 10004 | URL上appkey参数不能为空 |
| 10010 | 接口需要付费，请充值 |
| 10020 | 万象系统繁忙，请稍后再试 |
| 10030 | 调用万象网关失败， 请与万象联系 |
| 10040 | 超过每天限量，请明天继续 |
| 10050 | 用户已被禁用 |
| 10060 | 提供方设置调用权限，请联系提供方 |
| 10070 | 该数据只允许企业用户调用 |
| 10090 | 文件大小超限，请上传小于1M的文件 |
完整教学代码示例
<?php
/**
* Created by PhpStorm.
* User: FZS
* Time: 2021/01/01 21:26
*/
class freeApi
{
private $apiUrl;
public function __construct()
{
$this->apiUrl = 'https://way.jd.com/huoxin/here?lat=39.9928&lng=116.3961&cst=1&appkey=您申请的APPKEY';
}
/**
* 获取结果
* @return array
*/
public function getResult()
{
return file_get_contents($this->apiUrl);
}
}package main
import (
"fmt"
"io/ioutil"
"log"
"net/http"
)
const (
APIURL = "https://way.jd.com/huoxin/here?lat=39.9928&lng=116.3961&cst=1&appkey=您申请的APPKEY"
)
func main() {
queryUrl := fmt.Sprintf("%s",APIURL)
resp, err := http.Get(queryUrl)
if err != nil {
log.Println(err)
return
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}