浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

WebAPI文档全面上新

新增示例代码、在线运行等功能,帮助您实现快速接入,前往体验吧!

体验新版
服务介绍
服务文档
使用指南
常见问题
更新日志

时区服务

时区服务(又名Timezone API)是一类Web API接口服务;
用于查询全球某一位置所属时区信息以及与协调世界时(UTC)的时间偏移信息。

功能介绍
坐标点时区查询

解析全球任意坐标所属的时区信息。

timezone1.png

时间偏移查询

查询坐标所在地与协调世界时的时间偏移信息&夏令时时间偏移信息(针对部分国家地区)。

timezone2.png

接口功能介绍
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 E4805d16520de693a3fe707cdc962045
sn 若用户所用ak的校验方式为sn校验时该参数必须。sn生成  

返回结果参数
名称 类型 说明
status int 本次API访问状态,如果成功返回0,如果失败返回其他数字。
timezone_id string 所在时区ID字符串 详细了解
dst_offset int 夏令时(Daylight Saving Time:DST)时间偏移秒数
raw_offset int 坐标点位置时间较协调世界时偏移秒数
注:请求位置的实际时间=传入的timestamp+ dst_offset+ raw_offset
使用方法
编码说明

API请求中需要用到中文或一些特殊字符的参数,如query、region等,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成UTF-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。

字符集合 字符
URL非保留字
a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~
URL保留字
 ! * ' ( ) ; : @ & = + $ , / ? % # [ ]

如果中文参数中使用URL保留字字符的字面意思,例如:region关键字取值为"?北京",检索关键字包含一个问号,此问号也必须进行编码。

附注:

javascript中一般采用encodeURIComponent函数对特殊字符进行编码。

Java中可以使用函数URLEncoder.encode对特殊字符进行编码。

C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。

php中可以使用函数urlencode对特殊字符进行编码。

坐标系说明

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

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

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

时区服务默认输入输出坐标类型为百度坐标(BD09),同时可通过参数("coord_type","ret_coordtype")控制输入输出坐标类型。输入坐标支持以上三种坐标系,输出坐标支持-国测局坐标(GCJ02)和百度坐标(BD09)

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

服务配额

服务相关配额及并发请求限制请访问开发者权益页面查看。

服务常见问题
1、timestamp值应该如何设置?

timestamp,即Unix时间戳,结合location,用于判断是否需使用夏令时机制。
不同语言获取Unix时间戳方法不同,具体方法请参考:站长工具


2016年9月12日

V1.0


产品上线
开放全新时区服务


  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消