GeoGlobe JS SDK

Class: RTDS

.Service. RTDS

实时数据服务类，继承GeoGlobe.Service类。实时数据应用服务（RTDS）提供了查询和分析统计实时或历史数据的接口。GetCapabilities获取服务的能力及数据集信息；DescribeFeatureDataSet获取观测对象集合的描述信息；QueryFeature获取观测对象基本属性的元信息、基本属性值和具有此观测对象观测信息的数据集；GetObservation查询实时的观测值；GetObservationHistory按时间段查询观测对象的历史观测值；FeatureAggs支持先通过属性条件过滤某时间段的观测信息，然后聚合统计一个矩形（网格）范围内的观测信息；DescribeObservationDataSet获取数据集的描述信息。

new RTDS()

Author:
  • liuck
Source:
View2D/Service/RTDS.js
Example
GeoGlobe.ProxyHost = './proxy?url=';
var rtds = new GeoGlobe.Service.RTDS('实时数据服务', 'http://192.168.30.91:8080/RTDS/rtds',{
	version: '1.0.0',
	format: 'json'
});
rtds.getCapabilities(function(e){
	//TODO success
},function(e){
	//TODO faile
});
rtds.get...

Members

callback :String

使用JSONP方式的跨域通讯的flightHandler名
Type:
  • String
Default Value:
  • ''
Source:
View2D/Service/RTDS.js

format :String

输出格式，默认值为JSON
Type:
  • String
Default Value:
  • json
Source:
View2D/Service/RTDS.js

service :String

服务类型，值为RTDS
Type:
  • String
Default Value:
  • RTDS
Source:
View2D/Service/RTDS.js

version :String

服务版本号。
Type:
  • String
Default Value:
  • 1.0.0
Source:
View2D/Service/RTDS.js

Methods

describeFeatureDataSet(obsobjsetname, successFn, failFn)

获取指定观测对象集合的描述信息
Parameters:
Name Type Description
obsobjsetname String 要查询的观测对象集合标识，多个之间以逗号分隔
successFn function 请求成功的回调函数。
failFn function 请求失败的回调函数。
Source:
View2D/Service/RTDS.js
Example
GeoGlobe.ProxyHost = './proxy?url=';
	    var rtds = new GeoGlobe.Service.RTDS('实时数据服务', 'http://192.168.30.91:8080/RTDS/rtds',{
	    	version: '1.0.0',
	    	format: 'json'
	    });
		rtds.describeFeatureDataSet('taxidata_obj', function(e){
			//TODO success
		},function(e){
			//TODO faile
		})

describeObservationDataSet(datasetname, successFn, failFn)

获取指定数据集的描述信息
Parameters:
Name Type Description
datasetname String 要查询的数据集标识，多个之间以逗号分隔
successFn function 请求成功的回调函数。
failFn function 请求失败的回调函数。
Source:
View2D/Service/RTDS.js
Example
GeoGlobe.ProxyHost = './proxy?url=';
	    var rtds = new GeoGlobe.Service.RTDS('实时数据服务', 'http://192.168.30.91:8080/RTDS/rtds',{
	    	version: '1.0.0',
	    	format: 'json'
	    });
		rtds.describeObservationDataSet('taxidata', function(e){
			//TODO success
		},function(e){
			//TODO faile
		})

featureAggs(options, successFn, failFn)

支持先通过属性条件过滤某时间段的观测信息，然后聚合统计一个矩形（网格）范围内的观测信息。
Parameters:
Name Type Description
options Object 观测对象集合标识、观测对象标识和范围等条件
Properties
Name Type Description
datasetname String [必填]数据集标识,填写数据集名称
starttime DateTime [必填]时间段开始时间，格式为2016-04-13 12:00:00
endtime DateTime [必填]时间段结束时间，格式为2016-04-13 12:05:00
precision Int [可选]精度,填写数值0,1,2,3,4,5,6,7,8等整数值，0代表bbox类别，1及以上代表网格，数值越大查询的格网越小
aggtype String [可选]聚合方式，可为COUNT,SUM,AVG、MIN、MAX，格式为SUM,AVG（多个用逗号分隔），参数个数与STATISTICSPROPERTY的参数个数相等。当AGGTYPE为COUNT时，STATISTICSPRO可为空。不填默认为COUNT
groupbypro String [可选]观测属性分组字段，多个用“,”分隔，不填默认不分组
statisticspro String [可选]统计字段，格式为age,grade（多个用逗号分隔），参数个数与AGGTYPE的参数个数相等。不填默认求过滤和分组条件下文档COUNT
profilter Array.<Object> [可选]属性过滤条件，不填默认为查询所有，如:[{ "property": "name", "type": "string", "operator": "=", "value": "zs" }, { "property": "age", "type": "number", "operator": ">", "value": "18" }]
bbox Array [可选]按矩形范围查询，指定该参数时geometry参数无效，只针对观测对象本身具有位置信息时有效。格式为[-180,-90,180,90]
successFn function 请求成功的回调函数。
failFn function 请求失败的回调函数。
Source:
View2D/Service/RTDS.js
Example
GeoGlobe.ProxyHost = './proxy?url=';
	    var rtds = new GeoGlobe.Service.RTDS('实时数据服务', 'http://192.168.30.91:8080/RTDS/rtds',{
	    	version: '1.0.0',
	    	format: 'json'
	    });
		rtds.featureAggs({
			datasetname: 'taxidata',
			starttime: '2016-04-13 12:00:00',
			endtime: '2016-04-13 12:05:00',
			precision: 8,
			bbox: [-180,-90,180,90]
		}, function(e){
			//TODO success
		},function(e){
			//TODO faile
		})

getCapabilities(successFn, failFn)

获取服务能力描述信息
Parameters:
Name Type Description
successFn function 请求成功的回调函数。
failFn function 请求失败的回调函数。
Source:
View2D/Service/RTDS.js
Example
GeoGlobe.ProxyHost = './proxy?url=';
	    var rtds = new GeoGlobe.Service.RTDS('实时数据服务', 'http://192.168.30.91:8080/RTDS/rtds',{
	    	version: '1.0.0',
	    	format: 'json'
	    });
		rtds.getCapabilities(function(e){
			//TODO success
		},function(e){
			//TODO faile
		})

getObservation(options, successFn, failFn)

获取实时观测信息。根据观测对象及观测属性标识和范围等得到实时观测信息。
Parameters:
Name Type Description
options Object 观测对象集合标识、观测对象标识和范围等条件
Properties
Name Type Description
datasetname String [必填]数据集标识,填写数据集名称
externalid String [可选]观测对象标识，参数值为观测对象外部ID，多个之间以逗号分隔
observationproperty String [可选]观测属性，参数值为观测属性名称，多个之间以逗号分隔
bbox Array [可选]按矩形范围查询，指定该参数时geometry参数无效，只针对观测对象本身具有位置信息时有效。格式为[-180,-90,180,90]
geometry Array [可选]按几何范围查询，只针对观测对象本身具有位置信息时有效
startposition Int [可选]从指定位置开始返回结果，用于查询结果的分页
maxcount Int [可选]返回结果个数
successFn function 请求成功的回调函数。
failFn function 请求失败的回调函数。
Source:
View2D/Service/RTDS.js
Example
GeoGlobe.ProxyHost = './proxy?url=';
	    var rtds = new GeoGlobe.Service.RTDS('实时数据服务', 'http://192.168.30.91:8080/RTDS/rtds',{
	    	version: '1.0.0',
	    	format: 'json'
	    });
		rtds.getObservation({
			datasetname: 'taxidata',
			startposition: 0,
			maxcount: 100
		}, function(e){
			//TODO success
		},function(e){
			//TODO faile
		})

getObservationByCursor(options, successFn, failFn)

获取实时观测信息,通过游标方式查询。根据观测对象及观测属性标识和范围等得到实时观测信息。
Parameters:
Name Type Description
options Object 观测对象集合标识、观测对象标识和范围等条件
Properties
Name Type Description
datasetname String [必填]数据集标识,填写数据集名称
maxcount Int [必填]返回结果个数
externalid String [可选]观测对象标识，参数值为观测对象外部ID，多个之间以逗号分隔
observationproperty String [可选]观测属性，参数值为观测属性名称，多个之间以逗号分隔
bbox Array [可选]按矩形范围查询，指定该参数时geometry参数无效，只针对观测对象本身具有位置信息时有效。格式为[-180,-90,180,90]
geometry Array [可选]按几何范围查询，只针对观测对象本身具有位置信息时有效
successFn function 请求成功的回调函数。
failFn function 请求失败的回调函数。
Source:
View2D/Service/RTDS.js
Returns:
  • cursor - 游标对象
    Type
    Object
  • cursor.next - 通过游标获取下一份数据，数据获取得到后触发successFn回调函数。next函数返回true|false，true表示可以继续获取下一份数据，false表示游标已取完数据
    Type
    function
Example
GeoGlobe.ProxyHost = Cfg.proxyHostUrl;			
		var rtds = new GeoGlobe.Service.RTDS('实时数据服务', 'http://192.168.30.91:9010/RTDS/rtds',{
			version: '1.0.0',
			format: 'json'
		});
		var cursor = rtds.getObservationByCursor({
			datasetname: "test0810",
			maxcount: 5000
		},function(e){
			//TODO success
			convertAndPushData(e);//解析数据、展示等其他逻辑
			cursor.next();//通过游标，获取下一份数据
		},function(e){
			//TODO faile
		});

getObservationHistory(options, successFn, failFn)

根据数据集、观测对象标识和时间范围等获取观测对象的历史观测信息。
Parameters:
Name Type Description
options Object 观测对象集合标识、观测对象标识和范围等条件
Properties
Name Type Description
datasetname String [必填]数据集标识,填写数据集名称
externalid String [必填]观测对象标识，参数值为观测对象外部ID，多个之间以逗号分隔
starttime DateTime [必填]时间段开始时间，格式为2016-04-13 12:00:00
endtime DateTime [必填]时间段结束时间，格式为2016-04-13 12:05:00
observationproperty String [可选]观测属性，参数值为观测属性名称，多个之间以逗号分隔
samplemethod Int [可选]不填默认不采样， 1为时间均分采样
samplecount Int [可选]采样时间点个数，不填默认不采样，取该段时间所有观测值
successFn function 请求成功的回调函数。
failFn function 请求失败的回调函数。
Source:
View2D/Service/RTDS.js
Example
GeoGlobe.ProxyHost = './proxy?url=';
	    var rtds = new GeoGlobe.Service.RTDS('实时数据服务', 'http://192.168.30.91:8080/RTDS/rtds',{
	    	version: '1.0.0',
	    	format: 'json'
	    });
		rtds.getObservationHistory({
			datasetname: 'taxidata',
			externalid: 'taxi1',
			starttime: '2016-04-13 12:00:00',
			endtime: '2016-04-13 12:05:00'
		}, function(e){
			//TODO success
		},function(e){
			//TODO faile
		})

initialize(name, url, options)

GeoGlobe.Service.RTDS类的构造函数。
Parameters:
Name Type Description
name String 服务名称。
url String 服务地址。
options Object 实例的选项设置，此参数可选。
Properties
Name Type Description
service String 服务类型，值为RTDS
version String 服务版本号，值为1.0.0
format String 输出格式，值为JSON
callback String 使用JSONP方式的跨域通讯的flightHandler名，值为空
Source:
View2D/Service/RTDS.js

queryFeature(options, successFn, failFn)

根据观测对象集合标识、观测对象标识和范围等条件查询观测对象的属性元信息、属性值和含有该观测对象观测信息的数据集名称和描述。
Parameters:
Name Type Description
options Object 观测对象集合标识、观测对象标识和范围等条件
Properties
Name Type Description
obsobjsetname String [必填]观察对象集合标识
externalid String [可选]观测对象标识，参数值为观测对象外部ID，多个之间以逗号分隔
bbox Array [可选]按矩形范围查询，指定该参数时geometry参数无效，只针对观测对象本身具有位置信息时有效。格式为[-180,-90,180,90]
geometry Array [可选]按几何范围查询，只针对观测对象本身具有位置信息时有效
startposition Int [可选]从指定位置开始返回结果，用于查询结果的分页
maxcount Int [可选]返回结果个数
successFn function 请求成功的回调函数。
failFn function 请求失败的回调函数。
Source:
View2D/Service/RTDS.js
Example
GeoGlobe.ProxyHost = './proxy?url=';
	    var rtds = new GeoGlobe.Service.RTDS('实时数据服务', 'http://192.168.30.91:8080/RTDS/rtds',{
	    	version: '1.0.0',
	    	format: 'json'
	    });
		rtds.queryFeature({
			obsobjsetname: 'taxidata_obj',
			startposition: 0,
			maxcount: 100
		}, function(e){
			//TODO success
		},function(e){
			//TODO faile
		})