时间偏移查询
百度地图 官方文档
查询坐标所在地与协调世界时的时间偏移信息&夏令时时间偏移信息(针对部分国家地区)
基本说明:
接口地址: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;
    }
}