public class Location extends Object
| 限定符和类型 | 方法和说明 | ||||
|---|---|---|---|---|---|
ActiveLocationResp |
active(ActiveLocationReq req)
启用/停用地点,启用/停用地点
官网API文档链接:
ActiveLocationRespactive(ActiveLocationReq req,
RequestOptions reqOptions)
启用/停用地点,启用/停用地点
官网API文档链接:
BatchGetLocationRespbatchGet(BatchGetLocationReq req)
通过地点 ID 批量获取地点信息,该接口用于根据地点 ID批量查询地点信息,信息包含地点名称、描述、地点用途、工时制度、区域设置、时区以及关联的地址信息等。
| ||||
BatchGetLocationResp |
batchGet(BatchGetLocationReq req,
RequestOptions reqOptions)
通过地点 ID 批量获取地点信息,该接口用于根据地点 ID批量查询地点信息,信息包含地点名称、描述、地点用途、工时制度、区域设置、时区以及关联的地址信息等。
|
||||
PatchLocationResp |
patch(PatchLocationReq req)
更新地点,更新地点
官网API文档链接:
PatchLocationResppatch(PatchLocationReq req,
RequestOptions reqOptions)
更新地点,更新地点
官网API文档链接:
QueryMultiTimelineLocationRespqueryMultiTimeline(QueryMultiTimelineLocationReq req)
查询指定时间范围地点版本,- 接口支持查询出对象生效时间段在指定的start_date和end_date之间的版本(即:会查询出生效时间段和查询时间段有交集的版本);-
接口支持对象版本相关字段的查询和返回(默认返回id和version_id)
延迟说明:数据库主从延迟2s以内,即:直接创建对象后2s内调用此接口可能查询不到数据。
| ||||
QueryMultiTimelineLocationResp |
queryMultiTimeline(QueryMultiTimelineLocationReq req,
RequestOptions reqOptions)
查询指定时间范围地点版本,- 接口支持查询出对象生效时间段在指定的start_date和end_date之间的版本(即:会查询出生效时间段和查询时间段有交集的版本);-
接口支持对象版本相关字段的查询和返回(默认返回id和version_id)
延迟说明:数据库主从延迟2s以内,即:直接创建对象后2s内调用此接口可能查询不到数据。
|
||||
QueryRecentChangeLocationResp |
queryRecentChange(QueryRecentChangeLocationReq req)
查询当前生效信息发生变更的地点,查询指定时间范围内当前生效信息发生变更的地点,即只有地点当前生效版本的生效时间在查询时间范围内,才返回该地点id
-
时间窗支持大范围查询,限定查询范围在90天以内,例如要查询2020年1月1日至2020年6月30日的数据,建议分成两次查询,分别为2020年1月1日至2020年3月31日,2020年4月1日至2020年6月30日,不建议查询大时间范围数据
;- 未来生效的版本数据,会在生效日期当天凌晨产生变更事件。
|
||||
QueryRecentChangeLocationResp |
queryRecentChange(QueryRecentChangeLocationReq req,
RequestOptions reqOptions)
查询当前生效信息发生变更的地点,查询指定时间范围内当前生效信息发生变更的地点,即只有地点当前生效版本的生效时间在查询时间范围内,才返回该地点id
-
时间窗支持大范围查询,限定查询范围在90天以内,例如要查询2020年1月1日至2020年6月30日的数据,建议分成两次查询,分别为2020年1月1日至2020年3月31日,2020年4月1日至2020年6月30日,不建议查询大时间范围数据
;- 未来生效的版本数据,会在生效日期当天凌晨产生变更事件。
|
public Location(Config config)
public ActiveLocationResp active(ActiveLocationReq req, RequestOptions reqOptions) throws Exception
Exceptionpublic ActiveLocationResp active(ActiveLocationReq req) throws Exception
Exceptionpublic BatchGetLocationResp batchGet(BatchGetLocationReq req, RequestOptions reqOptions) throws Exception
延迟说明:数据库主从延迟 2s 以内,即:直接创建地点后2s内调用此接口可能查询不到数据。 ;
Exceptionpublic BatchGetLocationResp batchGet(BatchGetLocationReq req) throws Exception
延迟说明:数据库主从延迟 2s 以内,即:直接创建地点后2s内调用此接口可能查询不到数据。 ;
Exceptionpublic PatchLocationResp patch(PatchLocationReq req, RequestOptions reqOptions) throws Exception
Exceptionpublic PatchLocationResp patch(PatchLocationReq req) throws Exception
Exceptionpublic QueryMultiTimelineLocationResp queryMultiTimeline(QueryMultiTimelineLocationReq req, RequestOptions reqOptions) throws Exception
延迟说明:数据库主从延迟2s以内,即:直接创建对象后2s内调用此接口可能查询不到数据。 ;
Exceptionpublic QueryMultiTimelineLocationResp queryMultiTimeline(QueryMultiTimelineLocationReq req) throws Exception
延迟说明:数据库主从延迟2s以内,即:直接创建对象后2s内调用此接口可能查询不到数据。 ;
Exceptionpublic QueryRecentChangeLocationResp queryRecentChange(QueryRecentChangeLocationReq req, RequestOptions reqOptions) throws Exception
- 时间窗支持大范围查询,限定查询范围在90天以内,例如要查询2020年1月1日至2020年6月30日的数据,建议分成两次查询,分别为2020年1月1日至2020年3月31日,2020年4月1日至2020年6月30日,不建议查询大时间范围数据 ;- 未来生效的版本数据,会在生效日期当天凌晨产生变更事件。例如:今天为1月1日,新建地点 1月10日生效,则1月10日凌晨 1点之后可查询到;;- 默认排序条件:默认先按照组织记录 ID 增序排序, 便于滚动查询;- 使用滚动查询而非分页查询,是为了防止大批量获取数据时,深分页导致超时 ;
Exceptionpublic QueryRecentChangeLocationResp queryRecentChange(QueryRecentChangeLocationReq req) throws Exception
- 时间窗支持大范围查询,限定查询范围在90天以内,例如要查询2020年1月1日至2020年6月30日的数据,建议分成两次查询,分别为2020年1月1日至2020年3月31日,2020年4月1日至2020年6月30日,不建议查询大时间范围数据 ;- 未来生效的版本数据,会在生效日期当天凌晨产生变更事件。例如:今天为1月1日,新建地点 1月10日生效,则1月10日凌晨 1点之后可查询到;;- 默认排序条件:默认先按照组织记录 ID 增序排序, 便于滚动查询;- 使用滚动查询而非分页查询,是为了防止大批量获取数据时,深分页导致超时 ;
ExceptionCopyright © 2026. All rights reserved.