时间偏移查询-免费API,收集所有免费的API

基本说明：

接口地址：http://api.map.baidu.com/timezone/v1
返回格式：json
请求方式：get
请求示例：http://api.map.baidu.com/timezone/v1?location=-36.52,174.46&timestamp=1473130354&ak=你的ak

请求参数说明：

名称	类型	必填	说明
ak	string	必填	用户申请注册的key，自v2开始参数修改为“ak”，之前版本参数为“key”申请ak 扫码关注公众号
location	string	必填	需查询时区的位置坐标
timestamp	int	必填	所需时间（用于判断夏令时）。以协调世界时 1970 年 1 月 1 日午夜以来的秒数表示（即Unix时间戳）
sn	string	选填	若用户所用ak的校验方式为sn校验时该参数必须
coord_type	string	选填	请求参数中坐标的类型

返回参数说明：

名称	类型	说明
status	int	本次API访问状态，如果成功返回0，如果失败返回其他数字
timezone_id	string	所在时区ID字符串详细了解
dst_offset	int	夏令时(Daylight Saving Time：DST)时间偏移秒数
raw_offset	int	坐标点位置时间较协调世界时偏移秒数

JSON返回示例：

{
	"status": 0,
	"timezone_id": "Pacific/Auckland",
	"dst_offset": 0,
	"raw_offset": 43200
}

服务级错误码参照

错误码	说明
-	-

完整教学代码示例

<?php
/**
 * Created by PhpStorm.
 * User: FZS
 * Time: 2019/9/3 23:10
 */
//----------------------------------
// 时间偏移查询 调用类
//----------------------------------
class freeApi{
    private $ak;
    private $apiUrl;

    public function __construct($ak){
        $this->ak = $ak;
        $this->apiUrl = 'http://api.map.baidu.com/timezone/v1?coord_type=wgs84ll&location=-36.52,174.46&timestamp=1473130354&ak='.$this->ak;
    }
    /**
     * 获取结果
     * @return array
     */
    public function getResult(){
        return $this->freeApiCurl($this->apiUrl);
    }
    /**
     * 请求接口返回内容
     * @param  string $url [请求的URL地址]
     * @param  string $params [请求的参数]
     * @param  int $ipost [是否采用POST形式]
     * @return  string
     */
    public function freeApiCurl($url,$params=false,$ispost=0){
        $ch = curl_init();
        curl_setopt( $ch, CURLOPT_HTTP_VERSION , CURL_HTTP_VERSION_1_1 );
        curl_setopt( $ch, CURLOPT_HTTP_VERSION , CURL_HTTP_VERSION_1_1 );
        curl_setopt( $ch, CURLOPT_USERAGENT , 'free-api' );
        curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT , 60 );
        curl_setopt( $ch, CURLOPT_TIMEOUT , 60);
        curl_setopt( $ch, CURLOPT_RETURNTRANSFER , true );
        if( $ispost )
        {
            curl_setopt( $ch , CURLOPT_POST , true );
            curl_setopt( $ch , CURLOPT_POSTFIELDS , $params );
            curl_setopt( $ch , CURLOPT_URL , $url );
        }
        else
        {
            if($params){
                curl_setopt( $ch , CURLOPT_URL , $url.'?'.$params );
            }else{
                curl_setopt( $ch , CURLOPT_URL , $url);
            }
        }
        $response = curl_exec( $ch );
        if ($response === FALSE) {
            return false;
        }
        curl_close( $ch );
        return $response;
    }
}