您当前的位置: Web服务API > 开发指南 > Timezone
Timezone

产品介绍

Timezone API是一类接口服务,用于提供地球上某一位置所属时区信息以及与协调世界时(UTC)的时间偏移信息。

Timezone API已全面支持HTTP/HTTPS两种请求形式。后文介绍中以HTTP请求为例。

坐标系说明

WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。


GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。


BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标


Timezone API默认输入坐标类型为百度坐标(BD09),同时可通过参数("coord_type")控制输入坐标类型,输入坐标支持以上三种坐标系。


注意:不同类型坐标如需转换,请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法,以免影响坐标转换精度。

功能介绍

Timezone API提供时区相关信息的查询服务。
查询坐标点对应的时区。
查询对应时区与协调世界时的时间偏移。
查询坐标点对应时区的夏时令(Daylight Saving Time:DST)偏移。

使用限制

使用Timezone API服务前,首先需要登录API控制台申请密钥ak。

每个开发者账号每天调用Timezone API服务的总次数(即配额)是有限的。

每个开发者账号每分钟调用Timezone API服务的次数(即并发量)是有限的。

若需更高配额和并发量,请申请开发者认证以获取更高配额和更及时的技术支持。

同一个帐号下的HTTP/HTTPS请求,配额、并发共享。

默认配额及并发量说明如下:

分类 未认证 个人认证 企业认证
日配额(次) 2,000 30,000 100,000
分钟并发量(次/分钟) 1,200 3,000 6,000

使用方法

第一步,申请密钥(ak),作为访问服务的依据;

第二步,按照请求参数说明拼写发送HTTP/HTTPS请求的url,注意需使用第一步申请的ak;

第三步,接收HTTP/HTTPS请求返回的数据(json格式);

服务地址

http://api.map.baidu.com/timezone/v1/?

组成说明:

域名:api.map.baidu.com

服务名:timezone

服务版本号:v1

服务参数说明

参数 是否必须 默认值 示例 含义
location 39.934,116.387 需查询时区的位置坐标(纬度、经度)
coord_type 百度经纬度坐标 bd09ll 请求参数中坐标的类型,wgs84ll即GPS经纬度,gcj02ll即国测局经纬度坐标,bd09ll即百度经纬度坐标,bd09mc即百度米制坐标
timestamp 159768000 所需时间(用于判断夏时令)。以协调世界时 1970 年 1 月 1 日午夜以来的秒数表示。
ak 服务鉴权密钥
sn 若用户所用ak的校验方式为sn校验时该参数必须。

返回结果说明

结果字段 示例 含义
status 0 本次API访问状态,如果成功返回0,如果失败返回其他数字。
timezone_id Asia/Shanghai 所在时区ID字符串
dst_offset 3600 夏时令(Daylight Saving Time:DST)时间偏移秒数
raw_offset 43200 坐标点位置时间较协调世界时偏移秒数


请求位置的实际时间=传入的timestamp+ dst_offset+ raw_offset

使用示例

请求示例:

http://api.map.baidu.com/timezone/v1?coord_type=wgs84ll&location=-36.52,174.46&timestamp=1473130354&ak=你的ak

该请求表示: 请求调用百度时区接口服务。需查询时区的位置坐标为-36.52,174.46,该坐标为GPS经纬度坐标。timestamp设置为1473130354

返回结果示例:

status: 0,

timezone_id: "Pacific/Auckland",

dst_offset: 3600,

raw_offset: 43200

该返回结果表示: 请求中的坐标点所处时区ID为:Pacific/Auckland,夏时令时间偏移3600s,与协调世界时偏移43200s

状态码说明

状态码 含义
0 成功返回请求结果
2 请求参数错误
8 其他未分类错误(如无结果)