时区服务(又名Timezone API)是一类Web API接口服务;
用于查询全球某一位置所属时区信息以及与协调世界时(UTC)的时间偏移信息。
解析全球任意坐标所属的时区信息。
查询坐标所在地与协调世界时的时间偏移信息&夏令时时间偏移信息(针对部分国家地区)。
https://api.map.baidu.com/timezone/v1?coord_type=wgs84ll&location=-36.52,174.46×tamp=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 | 坐标点位置时间较协调世界时偏移秒数 |
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)
注意:不同类型坐标如需转换,请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法,以免影响坐标转换精度。
服务相关配额及并发请求限制请访问开发者权益页面查看。
timestamp,即Unix时间戳,结合location,用于判断是否需使用夏令时机制。
不同语言获取Unix时间戳方法不同,具体方法请参考:站长工具
2016年9月12日
V1.0