GeoGlobe JS SDK

Class: v1_1_0

.GeoCodingQuery. v1_1_0

地址匹配服务查询接口1.1.0版本，继承GeoGlobe.Query.GeoCodingQuery.v1类，本类可以实现如下功能： > 1.根据地址(例如：湖北省武汉市江夏区武大园一路9号)获取地理坐标(例如纬度29.58123 和经度113.41321)或者执行反向转换。 > 2.根据地理坐标获取地址信息。 > 3.可以根据地名地址分类名称或者地名地址分类编码获取地名地址分类信息。 > 4.可以根据多个地址信息查询到地理坐标信息。 > 5.可以根据多个地理坐标值获取地址信息。 > 说明:本类提供的五个接口的成功回调的返回内容存在两种情况：第一：是返回json对象，第二：是返回xml串。如果返回xml串， > 表示服务器内部发生错误或者客户端解析服务返回的结果时，发生了错误。

new v1_1_0()

Source:
View2D/Query/GeoCodingQuery/v1_1_0.js

Members

<static> method

数据请求方式，默认值是"get"。
Source:
View2D/Query/GeoCodingQuery/v1_1_0.js

Methods

<static> addressesToLocations(options, successFn, failFn, address, categoryCode, extent, resultType, maxCount, startPosition, semanticAnalysis, sortFields, filter, scoreFilter, statisticsLevel, customWeight)

根据地址匹配查询参数查询匹配的地址信息。
Parameters:
Name Type Description
options Object 请求参数。
successFn function 请求成功的回调函数。关于成功回调返回内容的结构，请参考：地址匹配结果.xsd。
failFn function 请求失败的回调函数。 options请求参数属性可为:
address String | Array(String) (可选，address和categoryCode必选一) 查询的地址名称集合。如果类别编码不为空，则地址名称可以为空。如果类别编码为空，则地址名称不能为空。
categoryCode Integer (可选，address和categoryCode必选一) 类别编码，该编码值可以通过获取分类的接口获取。
extent GeoGlobe.Bounds | GeoGlobe.Geometry.Polygon (可选) 查询的空间范围。缺省情况无查询范围限制。
resultType String (可选) 返回匹配结果的类型。 可供选择的值：(1)hits：返回匹配结果的总数；(2)result：返回匹配结果；(3)statistics：统计结果值。缺省值：result。
maxCount Integer (可选) 查询多少条数据。缺省情况是查询满足条件的所有结果。
startPosition Integer (可选) 从第几条开始查询，缺省值是1。
semanticAnalysis Boolean (可选) 针对匹配关键字是否做语义分析，默认值为true。
sortFields String (可选) 查询结果按照哪些字段排序，语法为："字段名称.ASC/DESC"，多个排序规则之间使用逗号隔开，例如："LCODE.ASC,CNAME.DESC"
filter GeoGlobe.Filter (可选) 匹配附加过滤条件.该参数与address参数的逻辑关系为且。
scoreFilter String (可选) 匹配度过滤，匹配结果的匹配度符合过滤条件时才输出，匹配度满分为100，过滤条件例如：score>=80、score<=70、90<=scosre<=95。
statisticsLevel Integer (可选) 统计级别。可供选择的值：1(省级)；2(市(县)级)；3(区级)。默认值为2。
customWeight Boolean (可选) 是否启动自定义权重排序，缺省为true。如设置为false，则按匹配度排序。
Source:
View2D/Query/GeoCodingQuery/v1_1_0.js
Example
(code)
		//根据范围和地址进行查询
    	var coding = new GeoGlobe.Query.GeoCodingQuery("http://192.168.40.69:7001/Test001/geocoding", {
			version:"1.1.0"
		});
		coding.addressesToLocations({
			extent:GeoGlobe.Bounds.fromString("-180,-90,180,90"),
			address:"法库县"
		},function(GeoCoding) {},function() {});
(end)

<static> batchAddressesToLocations(options, successFn, failFn, address, sortFields, filter, scoreFilter, singleKeywordResultCount)

根据一到多个地址查询坐标位置信息。
Parameters:
Name Type Description
options Object 请求参数。
successFn function 请求成功的回调函数。关于成功回调返回内容的结构，请参考：地址匹配结果.xsd。
failFn function 请求失败的回调函数。 options请求参数属性可为:
address Array(String) (必选) 查询的地址名称集合。
sortFields String (可选) 查询结果按照哪些字段排序，语法为："字段名称.ASC/DESC"，多个排序规则之间使用逗号隔开，例如："LCODE.ASC,CNAME.DESC"
filter GeoGlobe.Filter (可选) 匹配附加过滤条件.该参数与address参数的逻辑关系为且。
scoreFilter String (可选) 匹配度过滤，匹配结果的匹配度符合过滤条件时才输出，匹配度满分为100，过滤条件例如：score>=80、score<=70、90<=scosre<=95
singleKeywordResultCount Integer (可选) 单个关键字匹配地址个数，用于限制服务返回的匹配结果数,默认值为1。
Source:
View2D/Query/GeoCodingQuery/v1_1_0.js
Example
(code)
		//根据范围和地址进行查询
    	var coding = new GeoGlobe.Query.GeoCodingQuery("http://192.168.40.69:7001/Test001/geocoding", {
			version:"1.1.0"
		});
		coding.batchAddressesToLocations({
			address:["小学"],
			singleKeywordResultCount:2,
			sortFields:"address.desc",
			scoreFilter:"0<=score<=88"
		
		},function(GeoCodingResult) {
			
		},function() {});
(end)

<static> batchGetAddresses(options, successFn, failFn, lonlats, tolerance, unit, sortFields, scoreFilter, singleKeywordResultCount)

根据多个坐标位置查找匹配的地址信息。成功回调返回的结果数据为地址信息要素({})。
Parameters:
Name Type Description
options Object 请求参数。
successFn function 请求成功的回调函数。关于成功回调返回内容的结构，{} – 地址信息要素。
failFn function 请求失败的回调函数。 options请求参数属性可为:
lonlats Array(GeoGlobe.LonLat) (必选) 坐标位置数组。
tolerance Number (可选) 容差范围，默认值为100。如果unit属性设置为degree，则对应的值为0.000899。
unit String (可选)容差的单位，参数可设置为（degree、meter、km）。默认值为"meter"。
sortFields String (可选) 查询结果按照哪些字段排序，语法为："字段名称.ASC/DESC"，多个排序规则之间使用逗号隔开，例如："LCODE.ASC,CNAME.DESC"。
scoreFilter String (可选) 匹配度过滤，匹配结果的匹配度符合过滤条件时才输出，匹配度满分为100，过滤条件例如：score>=80、score<=70、90<=scosre<=95。
singleKeywordResultCount Integer (可选) 单个关键字匹配地址个数，用于限制服务返回的匹配结果数,默认值为1。
Source:
View2D/Query/GeoCodingQuery/v1_1_0.js
Example
(code)
		//根据坐标位置和容差进行查询
    	var coding = new GeoGlobe.Query.GeoCodingQuery("http://192.168.40.69:7001/Test001/geocoding", {
			version:"1.1.0"
		});
		coding.batchGetAddresses({
			lonlats:[new GeoGlobe.LonLat(123.43888042, 41.759929371),new GeoGlobe.LonLat(123.423848649, 41.771748608)],
			singleKeywordResultCount:2,
			tolerance:0.5,
			unit:"degree",
			sortFields:"address.desc",
			scoreFilter:"0<=score<=88"
		
		},function(GeoCodingResult) {
			//返回值 GeoCodingResult - {Object} 对象属性包含:status, features
		},function() {});
(end)

<static> batchGetLocations(options, successFn, failFn, address, sortFields, filter, scoreFilter, singleKeywordResultCount)

根据一到多个地址查询坐标位置信息。成功回调返回的结果数据为地址信息要素({})。
Parameters:
Name Type Description
options Object 请求参数。
successFn function 请求成功的回调函数。关于成功回调返回内容的结构，{ GeoGlobe.Feature} – 地址信息要素。
failFn function 请求失败的回调函数。 options请求参数属性可为:
address Array(String) (必选) 查询的地址名称集合。
sortFields String (可选) 查询结果按照哪些字段排序，语法为："字段名称.ASC/DESC"，多个排序规则之间使用逗号隔开，例如："LCODE.ASC,CNAME.DESC"
filter GeoGlobe.Filter (可选) 匹配附加过滤条件.该参数与address参数的逻辑关系为且。
scoreFilter String (可选) 匹配度过滤，匹配结果的匹配度符合过滤条件时才输出，匹配度满分为100，过滤条件例如：score>=80、score<=70、90<=scosre<=95
singleKeywordResultCount Integer (可选) 单个关键字匹配地址个数，用于限制服务返回的匹配结果数,默认值为1。
Source:
View2D/Query/GeoCodingQuery/v1_1_0.js
Example
(code)
		//根据范围和地址进行查询
    	var coding = new GeoGlobe.Query.GeoCodingQuery("http://192.168.40.69:7001/Test001/geocoding", {
			version:"1.1.0"
		});
		coding.batchGetLocations({
			address:["小学"],
			singleKeywordResultCount:2,
			sortFields:"address.desc",
			scoreFilter:"0<=score<=88"
		
		},function(GeoCodingResult) {
			//返回值 GeoCodingResult - {Object} 对象属性包含:status, features
		},function() {});
(end)

<static> batchLocationToAddresses(options, successFn, failFn, tolerance, unit, sortFields, scoreFilter, singleKeywordResultCount)

根据多个坐标位置查找匹配的地址信息。
Parameters:
Name Type Description
options Object 请求参数。
successFn function 请求成功的回调函数。关于成功回调返回内容的结构，请参考：地址匹配结果.xsd。
failFn function 请求失败的回调函数。 options请求参数属性可为:
Array(GeoGlobe.LonLat)} lonlats - {(必选) 坐标位置数组。
tolerance Number (可选) 容差范围，默认值为100。如果unit属性设置为degree，则对应的值为0.000899。
unit String (可选)容差的单位，参数可设置为（degree、meter、km）。默认值为"meter"。
sortFields String (可选) 查询结果按照哪些字段排序，语法为："字段名称.ASC/DESC"，多个排序规则之间使用逗号隔开，例如："LCODE.ASC,CNAME.DESC"。
scoreFilter String (可选) 匹配度过滤，匹配结果的匹配度符合过滤条件时才输出，匹配度满分为100，过滤条件例如：score>=80、score<=70、90<=scosre<=95。
singleKeywordResultCount Integer (可选) 单个关键字匹配地址个数，用于限制服务返回的匹配结果数,默认值为1。
Source:
View2D/Query/GeoCodingQuery/v1_1_0.js
Example
(code)
		//根据坐标位置和容差进行查询
    	var coding = new GeoGlobe.Query.GeoCodingQuery("http://192.168.40.69:7001/Test001/geocoding", {
			version:"1.1.0"
		});
		coding.batchLocationToAddresses({
			lonlats:[new GeoGlobe.LonLat(123.43888042, 41.759929371),new GeoGlobe.LonLat(123.423848649, 41.771748608)],
			singleKeywordResultCount:2,
			tolerance:0.5,
			unit:"degree",
			sortFields:"address.desc",
			scoreFilter:"0<=score<=88"
		
		},function(GeoCodingResult) {

		},function() {});
(end)

<static> getAddresses(options, successFn, failFn, lonlat, tolerance, unit, resultType, maxCount, startPosition, sortFields, scoreFilter)

根据位置查找匹配的地址信息。成功回调返回的结果数据为地址信息要素({})。
Parameters:
Name Type Description
options Object 请求参数。
successFn function 请求成功的回调函数。关于成功回调返回内容的结构，{} – 地址信息要素。
failFn function 请求失败的回调函数。 options请求参数属性可为:
lonlat GeoGlobe.LonLat (必选) 位置。
tolerance Number (可选) 容差范围，默认值为100。如果unit属性设置为degree，则对应的值为0.000899。
unit String (可选)容差的单位，参数可设置为（degree、meter、km）。默认值为"meter"。
resultType String (可选) 返回匹配结果的类型。 可供选择的值：hits：返回匹配结果的总数，result：返回匹配结果，缺省值：result。
maxCount Integer (可选) 查询多少条数据。缺省情况是查询满足条件的所有结果。
startPosition Integer (可选) 从第几条开始查询，缺省值是1。
sortFields String (可选) 查询结果按照哪些字段排序，语法为："字段名称.ASC/DESC"，多个排序规则之间使用逗号隔开，例如："LCODE.ASC,CNAME.DESC"。
scoreFilter String (可选) 匹配度过滤，匹配结果的匹配度符合过滤条件时才输出，匹配度满分为100，过滤条件例如：score>=80、score<=70、90<=scosre<=95。
Source:
View2D/Query/GeoCodingQuery/v1_1_0.js
Example
(code)
		//根据坐标位置和容差进行查询
    	var coding = new GeoGlobe.Query.GeoCodingQuery("http://192.168.40.69:7001/Test001/geocoding", {
			version:"1.1.0"
		});
		coding.getAddresses({
			lonlat:new GeoGlobe.LonLat(41.79427361488343,123.3541488647461),
			tolerance:0.000899
		},function(GeoCoding) {
			//返回值 GeoCoding - {Object} 对象属性包含:status, features
		},function() {});
(end)

<static> getAddressesByPage(options, successFn, failFn, lonlat, tolerance, unit, maxCount, sortFields, scoreFilter)

根据位置查找匹配的地址信息-分页查询。成功回调返回的结果数据为地址信息要素({})。
Parameters:
Name Type Description
options Object 请求参数。
successFn function 请求成功的回调函数。关于成功回调返回内容的结构，{} – 地址信息要素。
failFn function 请求失败的回调函数。 options请求参数属性可为:
lonlat GeoGlobe.LonLat (必选) 位置。
tolerance Number (可选) 容差范围，默认值为100。如果unit属性设置为degree，则对应的值为0.000899。
unit String (可选)容差的单位，参数可设置为（degree、meter、km）。默认值为"meter"。
maxCount Integer (可选) 查询多少条数据。缺省情况是查询满足条件的所有结果。
sortFields String (可选) 查询结果按照哪些字段排序，语法为："字段名称.ASC/DESC"，多个排序规则之间使用逗号隔开，例如："LCODE.ASC,CNAME.DESC"。
scoreFilter String (可选) 匹配度过滤，匹配结果的匹配度符合过滤条件时才输出，匹配度满分为100，过滤条件例如：score>=80、score<=70、90<=scosre<=95。
Source:
View2D/Query/GeoCodingQuery/v1_1_0.js
Example
(code)
		//根据坐标位置和容差进行查询
    	var coding = new GeoGlobe.Query.GeoCodingQuery("http://192.168.40.69:7001/Test001/geocoding", {
			version:"1.1.0"
		});
		coding.getAddressesByPage({
			lonlat:new GeoGlobe.LonLat(41.79427361488343,123.3541488647461),
			tolerance:0.000899
		},function(GeoCoding) {
			//返回值 GeoCoding - {Object} 对象属性包含:status, features
		},function() {});
(end)

<static> getLocations(options, successFn, failFn, address, categoryCode, extent, resultType, maxCount, startPosition, semanticAnalysis, sortFields, filter, scoreFilter)

根据地址匹配查询参数查询匹配的地址信息。成功回调返回的结果数据为地址信息要素({GeoGlobe.Feature})。
Parameters:
Name Type Description
options Object 请求参数。
successFn function 请求成功的回调函数。关于成功回调返回内容的结构，{GeoGlobe.Feature} – 地址信息要素。
failFn function 请求失败的回调函数。 options请求参数属性可为:
address String | Array(String) (可选，address和categoryCode必选一) 查询的地址名称集合。如果类别编码不为空，则地址名称可以为空。如果类别编码为空，则地址名称不能为空。
categoryCode Integer (可选，address和categoryCode必选一) 类别编码，该编码值可以通过获取分类的接口获取。
extent GeoGlobe.Bounds (可选) 查询的空间范围。缺省情况无查询范围限制。
resultType String (可选) 返回匹配结果的类型。 可供选择的值：hits：返回匹配结果的总数，result：返回匹配结果，缺省值：result。
maxCount Integer (可选) 查询多少条数据。缺省情况是查询满足条件的所有结果。
startPosition Integer (可选) 从第几条开始查询，缺省值是1。
semanticAnalysis Boolean (可选) 针对匹配关键字是否做语义分析，默认值为true。
sortFields String (可选) 查询结果按照哪些字段排序，语法为："字段名称.ASC/DESC"，多个排序规则之间使用逗号隔开，例如："LCODE.ASC,CNAME.DESC"
filter GeoGlobe.Filter (可选) 匹配附加过滤条件.该参数与address参数的逻辑关系为且。
scoreFilter String (可选) 匹配度过滤，匹配结果的匹配度符合过滤条件时才输出，匹配度满分为100，过滤条件例如：score>=80、score<=70、90<=scosre<=95。
Source:
View2D/Query/GeoCodingQuery/v1_1_0.js
Example
(code)
		//根据范围和地址进行查询
    	var coding = new GeoGlobe.Query.GeoCodingQuery("http://192.168.40.69:7001/Test001/geocoding", {
			version:"1.1.0"
		});
		coding.getLocations({
			extent:GeoGlobe.Bounds.fromString("-180,-90,180,90"),
			address:"法库县"
		},function(GeoCoding) {
			//返回值 GeoCoding - {Object} 对象属性包含:status, features
		},function() {});
(end)

<static> getLocationsByPage(options, successFn, failFn, address, categoryCode, extent, maxCount, semanticAnalysis, sortFields, filter, scoreFilter)

根据地址匹配查询参数查询匹配的地址信息-分页查询。成功回调返回的结果数据为地址信息要素({})。
Parameters:
Name Type Description
options Object 请求参数。
successFn function 请求成功的回调函数。关于成功回调返回内容的结构，{} – 地址信息要素。
failFn function 请求失败的回调函数。 options请求参数属性可为:
address String | Array(String) (可选，address和categoryCode必选一) 查询的地址名称集合。如果类别编码不为空，则地址名称可以为空。如果类别编码为空，则地址名称不能为空。
categoryCode Integer (可选，address和categoryCode必选一) 类别编码，该编码值可以通过获取分类的接口获取。
extent GeoGlobe.Bounds (可选) 查询的空间范围。缺省情况无查询范围限制。
maxCount Integer (可选) 查询多少条数据。缺省情况是查询满足条件的所有结果。
semanticAnalysis Boolean (可选) 针对匹配关键字是否做语义分析，默认值为true。
sortFields String (可选) 查询结果按照哪些字段排序，语法为："字段名称.ASC/DESC"，多个排序规则之间使用逗号隔开，例如："LCODE.ASC,CNAME.DESC"
filter GeoGlobe.Filter (可选) 匹配附加过滤条件.该参数与address参数的逻辑关系为且。
scoreFilter String (可选) 匹配度过滤，匹配结果的匹配度符合过滤条件时才输出，匹配度满分为100，过滤条件例如：score>=80、score<=70、90<=scosre<=95。
Source:
View2D/Query/GeoCodingQuery/v1_1_0.js
Example
(code)
		//根据范围和地址进行查询
    	var coding = new GeoGlobe.Query.GeoCodingQuery("http://192.168.40.69:7001/Test001/geocoding", {
			version:"1.1.0"
		});
		coding.getLocationsByPage({
			extent:GeoGlobe.Bounds.fromString("-180,-90,180,90"),
			address:"法库县"
		},function(GeoCoding) {
			//返回值 GeoCoding - {Object} 对象属性包含:status, features
		},function() {});
(end)

<static> initialize(url, options)

GeoGlobe.Query.GeoCodingQuery.v1_1_0类的构造函数。
Parameters:
Name Type Description
url String 服务地址。
options Object 相关属性的设置项，可选。 options请求参数属性可为: 服务版本。
Source:
View2D/Query/GeoCodingQuery/v1_1_0.js

<static> locationToAddresses(options, successFn, failFn, lonlat, tolerance, unit, resultType, maxCount, startPosition, sortFields, scoreFilter)

根据位置查找匹配的地址信息。
Parameters:
Name Type Description
options Object 请求参数。
successFn function 请求成功的回调函数。关于成功回调返回内容的结构，请参考：地址匹配结果.xsd。
failFn function 请求失败的回调函数。 options请求参数属性可为:
lonlat GeoGlobe.LonLat (必选) 位置。
tolerance Number (可选) 容差范围，默认值为100。如果unit属性设置为degree，则对应的值为0.000899。
unit String (可选)容差的单位，参数可设置为（degree、meter、km）。默认值为"meter"。
resultType String (可选) 返回匹配结果的类型。 可供选择的值：hits：返回匹配结果的总数，result：返回匹配结果，缺省值：result。
maxCount Integer (可选) 查询多少条数据。缺省情况是查询满足条件的所有结果。
startPosition Integer (可选) 从第几条开始查询，缺省值是1。
sortFields String (可选) 查询结果按照哪些字段排序，语法为："字段名称.ASC/DESC"，多个排序规则之间使用逗号隔开，例如："LCODE.ASC,CNAME.DESC"。
scoreFilter String (可选) 匹配度过滤，匹配结果的匹配度符合过滤条件时才输出，匹配度满分为100，过滤条件例如：score>=80、score<=70、90<=scosre<=95。
Source:
View2D/Query/GeoCodingQuery/v1_1_0.js
Example
(code)
		//根据坐标位置和容差进行查询
    	var coding = new GeoGlobe.Query.GeoCodingQuery("http://192.168.40.69:7001/Test001/geocoding", {
			version:"1.1.0"
		});
		coding.locationToAddresses({
			lonlat:new GeoGlobe.LonLat(41.79427361488343,123.3541488647461),
			tolerance:0.000899
		},function(GeoCoding) {

		},function() {});
(end)