时区服务 | 百度地图API SDK

所有文档

时区

服务概览

快速开始

使用准备

接口文档

服务功能

时区

相关资料

更新日志常见问题资源下载使用指南

时区服务

下载开发文档

API服务地址

https://api.map.baidu.com/timezone/v1?coord_type=wgs84ll&location=-36.52,174.46&timestamp=1473130354&ak=您的ak
//GET请求

请求参数

参数名称	含义	类型	举例	默认值	是否必须
location	需查询时区的位置坐标（纬度、经度）,当前仅支持全球陆地坐标查询，海域坐标暂不支持。	float	39.934,116.387	无	是
coord_type	请求参数中坐标的类型，wgs84即GPS经纬度，gcj02即国测局经纬度坐标，bd09ll即百度经纬度坐标，bd09mc即百度米制坐标坐标系说明	string	bd09ll，gcj02ll，wgs84ll，bd09mc	bd09ll	否
timestamp	所需时间（用于判断夏令时）。以协调世界时 1970 年 1 月 1 日午夜以来的秒数表示（即Unix时间戳）。	int	159768000	无	是
ak	服务鉴权密钥申请ak	string	E4805d165*******cdc962045	无	是
sn	若用户所用ak的校验方式为sn校验时该参数必须。sn生成	无

返回参数

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

示例代码

填写您的AK

输入AK可生成包含IP/SN校验方式的代码

PHP

C++

Python

JAVA

Bash


<?php 
    // 此处填写你在控制台-应用管理-创建应用后获取的AK
    $ak = '您的AK';
    
    // 发起一个http get请求，并返回请求的结果
    // $url字段为请求的地址
    // $param字段为请求的参数
    function request_get($url = '', $param = array()) {
        if (empty($url) || empty($param)) {
            return false;
        }
        
        $getUrl = $url . "?" . http_build_query($param);
        $curl = curl_init(); // 初始化curl
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); // 跳过证书检查   
        curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2); // 从证书中检查SSL加密算法是否存在
        curl_setopt($curl, CURLOPT_URL, $getUrl); // 抓取指定网页
        curl_setopt($curl, CURLOPT_TIMEOUT, 1000); // 设置超时时间1秒
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); // curl不直接输出到屏幕
        curl_setopt($curl, CURLOPT_HEADER, 0); // 设置header
        $data = curl_exec($curl); // 运行curl

        if (!$data) {
            print("an error occured in function request_get(): " . curl_error($curl) . "\n");
        }

        curl_close($curl);
        
        return $data;
    }

    // 请求地址
    $url = 'https://api.map.baidu.com/timezone/v1';
    
    // 构造请求参数
    $param['coord_type']   = 'wgs84ll';
    $param['location']   = '-36.52,174.46';
    $param['timestamp']   = '1473130354';
    $param['ak']   = $ak;

    $res = request_get($url, $param);

    // 将原始返回的结果打印出来
    print("请求的原始返回结果为:\n");
    print($res . "\n");
?>

JSON


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

在线运行

参数	备注	必选
coord_type	wgs84ll	是
location	-36.52,174.46	是
timestamp	1473130354	是