城市查询
京东万象 官方文档
获取城市所属省份,经纬度等相关信息
基本说明:
接口地址:https://way.jd.com/he/freecity
返回格式:json
请求方式:get/post
请求示例:https://way.jd.com/he/freecity?city=beijing&appkey=APPKEY
请求参数说明:
名称 类型 必填 说明
appkey string 必填 该平台的appkey 扫码关注公众号
city string 必填 可通过城市中英文名称、ID和IP地址进行,例如city=北京,city=beijing,city=CN101010100,city= 60.194.130.1
返回参数说明:
名称 类型 说明
basic string 基本信息
city string 城市名
cnty string 国家
lat string 纬度
prov string 省份
lon string 经度
id string 城市ID
JSON返回示例:
{
	"code": "10000",
	"charge": false,
	"msg": "查询成功",
	"result": {
		"HeWeather5": [{
			"basic": {
				"city": "北京",
				"cnty": "中国",
				"id": "CN101010100",
				"lat": "39.904000",
				"lon": "116.391000",
				"prov": "直辖市"
			},
			"status": "ok"
		}]
	}
}
服务级错误码参照
错误码 说明
10000 查询成功
10001 错误的请求appkey
11010 商家接口调用异常,请稍后再试
11030 商家接口返回格式有误
10003 不存在相应的数据信息
10004 URL上appkey参数不能为空
10010 接口需要付费,请充值
10020 万象系统繁忙,请稍后再试
10030 调用万象网关失败, 请与万象联系
10040 超过每天限量,请明天继续
10050 用户已被禁用
10060 提供方设置调用权限,请联系提供方
10070 该数据只允许企业用户调用
10090 文件大小超限,请上传小于1M的文件
完整教学代码示例
<?php
/**
 * Created by PhpStorm.
 * User: FZS
 * Time: 2020/12/01 22:26
 */
class freeApi
{
    private $apiUrl;

    public function __construct()
    {
        $this->apiUrl = 'https://way.jd.com/he/freeweather?city=freecity&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/he/freeweather?city=freecity&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))
}