xx市地理信息共享服务平台-地名地址服务规范

XX市地理信息共享服务平台

服务系列规范

地名地址

服务规范

（草案）

目录

1引言............................................................................0

2服务概述........................................................................0

3地理编码管理服务接口..........................................................1

3.1接口索引..................................................................1

3.2请求参数说明..............................................................1

3.3请求示例..................................................................1

4地理编码元数据服务接口........................................................3

4.1接口索引..................................................................3

4.2请求参数说明.............................................................3

4.3请求示例..................................................................4

5正向地理编码服务接口..........................................................7

5.1接口索引..................................................................7

5.2请求参数说明.............................................................7

5.3请求示例..................................................................8

6逆向地理编码服务接口.........................................................14

6.1接口索引.................................................................14

6.2请求参数说明............................................................14

6.3请求示例.................................................................14

7地理地址要素服务接口.........................................................18

7.1接口索引.................................................................18

7.2请求参数说明............................................................18

7.3请求示例.................................................................18

1引言

本规范适用于XX市地理信息共享服务平台(以下简称“共享服务平台”)关

于地名地址服务的接口规范，以便于指导相关部门组织开发使用。

2服务概述

地名地址匹配服务(addressmatching)又称为地理编码(Geocoding),是指

建立地理位置坐标与给定地址一致性的过程，也指在地图上找到并标明每条地址

所对应的位置。

随着地理信息系统在城市信息化建设中越来越广泛的应用，部门之间对空间

数据与非空间数据共享整合的要求日益迫切。政府各部门拥有大量的政务信息

(I',相当多的信息都与地理空间位置密切相关，但是这些信息几乎都没有空间坐

标，因此无法与其他信息整合，无法实现空间分析与可视化。为了将这些空间信

息与非空间信息集成与融合，实现统计和表格信息的空间化，就需要建立空间和

非空间信息之间的联系，地理编码正是建立这两者之间联系的最重要手段。以地

名/地址数据作为基础纽带，通过地理编码，使政府各部门分散的信息资源库之

间建立有机的联系，从而在统一的地理参考框架中，构建起空间信息和非空间信

息进行融合的框架和模型，依据此框架和模型可以满足直接的、实时的数据共享

要求，实现不同数据类型、不同系统之间的集成操作。

地理编码在经济社会加人们的口常生活中起着十分重要的作用。在建立地

名、路名、楼名和门址等数据库后，可支持与位置相关的服务，如LBS、智能交

通、移动梦网、影像数据库的查询等；对社会、经济和人口信息可以进行匹配，

从而进行分析、统计、管理、制图和可视化表示，以支持政府的管理和决策。

本共享服务平台将所有的地名地址分为五个不同的类型：门牌号、楼栋号、

兴趣点、道路、行政区划,搜索时可以指定某个类别进行搜索。

表1地名地址匹配服务接口总索引

序号接口分类服务接口功能说明

1HasGcocodcPcnnission当前用户是否具有地理编码的权限。

管理服务接口

2HasRevei'seGeocodePermission当前用户是否具有地理反编码的权限。

3得到特定类型的地名定位图层（地名地址

GctAddressLaycr

地理编码元数元数据查询）。

4据服务接口得到所芍地名定位图层（地名地址元数据

Gct/MIAddressLayer

查询）。

5FindAddress获取地名地址信息.

正向地理编码

6FindAddressByName由给定关犍字获取地名地址信息。

服务接口

7FindAddressByGeometry由给定空间信息获取地名地址信息。

8ReverseGeocode由给定位置点进行地理反编码。

逆向地理编码

9服务接口由给定位置点和反编码类型进行地理反

ReveneGeocodeByType

编码。

3地理编码管理服务接口

3.1接口索引

序号服务接口功能说明

1HasGeocodePermission当前用户是否具有地理编码的权限。

2HasReverseGeocodePennission当前用户是否具有地理反编码的权限。

3.2请求参数说明

参数必填类型说明

FORMAT否string信息返回类型，支持以下类型：xmljsonjavascript

CALLBACK否string请求回调函数，当返回类型为javascript时，此参数有效

3.3请求示例

3.3.1当前用户是否具有地理编码的权限查询接口（HasGeocodePermission）

1.请求URL一

请求响应

<?xmlversion="1.0"encoding="utf-8"?>

<boolcan>true</boolcan>

2.请求URL二

请求响应

（略）

3.请求URL三

请求响应

（略）

3.3.2当前用户是否具有地理逆编码的权限查询接口（HasReverseGeocodePermission）

1.请求URL一

请求响应

<?xmlversion="1.0"encoding=Hutf-8"?>

<boolean>true</boolean>

2.请求URL二

请求响应

（略）

3.请求URL三

-2-

请求响应

（略）

4地理编码元数据服务接口

此类请求用于获取当前系统中的所有资源信息，主要目的是使客户端在使用

资源前对资源状况有一个送本的了解。该服务接口用于获取当前系统中所有参与

地名地址分析的空间图层信息。

4.1接口索引

序号服务接口功能说明

IGetAllAddressLayer得到所有地名定位图层（地名地址元数据查询）。

2GetAddressLayer得到特定类型的地名定位图层（地名地址元数据查询）。

4.2请求参数说明

参数必填类型说明

FORMAT否string信息返I可类型，支持以下类型：xmljsonjavascript

CALLBACK否string请求回调函数，当返回类型为javascript时，此参数有效

AddressTyper：String地名类别信息，只在GetAddressLayer接口使用.

注：地名类别信息的各项常量枚举如下:

序号地名类别名称地名类别名称描述

iAll所有类型

2District行政区地名

3Road道路地名

4PointAddress兴趣点

-3-

5Building楼栋号

6DoorPlate门牌号

4.3请求示例

4.3.1得到所有地名定位图层服务接口(GetAllAddressLayer)

1.请求UR—

请求响应(节选)

<?xmlversion="1.0"encoding="utf-8"?>

<ArrayOfLayer

xmlns:xsi="http://www./2001/XMLSchema-instance"

xmlns:xsd="/2001/XMLSchema">

<Layer>

<GeocodingLayerID>6</GeocodingLayerID>

<DataSourceID>20</DataSourceID>

<AliasName>高速公路</AliasName>

<LayerName>SDE.ClSQHIGHWAYS</LayerName>

<DescriptionField/>

<LayerType>2</LayerType>

<GeographicalCode>2300</GeographicalCode>

<NameField>NAME</NameField>

<CodeField/>

<ExtendField/>

</Layer>

<Layer>

<GeocodingLayerID>3</GeocodingLayerID>

<DataSourceID>20</DataSourceID>

<AliasName>xx区划v/AlhsName〉

<LayerName>SDE.ClSQDISTRICTS</LayerName>

<DescriptionField/>

<LayerType>3</LayerType>

<GeographicalCode>2140</GeographicalCode>

<NameField>NAME</NameField>

<CodeField/>

<ExtendField/>

</Layer>

<Layer>

<GeocodingLayerID>5</GeocodingLayerID>

<DataSourceID>20</DataSourceID>

-4-

<AliasName>社区（村）</AliasName>

<LayerName>SDE.COMMUNITY</LayerName>

<DescriptionField/>

<LayerType>3</Layerlype>

<GeographicalCode>2160</GeographicalCode>

<NameField>COMMUNITY</NameField>

<CodeField>COMMUNlTlD</CodeField>

<ExtendField/>

</Layer>

2.请求URL.

请求响应

（略）

4.3.2得到特定类型的地名定位图层服务接口（GetAddressLayer）

1.请求URL一

请求响应（节选）

<?xmlversion="1.0"encoding=uutf-8"?>

<ArrayOfLayer

xmlns:xsi="http:///2001/XMLSchema-instance"

xmlns:xsd="/2001/XMLSchema">

<Layer>

<GeocodingLayerID>6</GeocodingLayerID>

<DataSourceID>20</DataSourceID>

vAliasName>高速公路v/AliasName>

<LayerName>SDE.ClSQHIGHWAYS</LayerName>

<DescriptionField/>

<LayerType>2</LayerType>

<GeographicalCode>2300</GeographicalCode>

<NameField>N>\ME</NameField>

<CodeField/>

<bxtendf-ield/>

</Layer>

<Layer>

<GeocodingLayerID>8</GeocodingLayerID>

<DataSourceID>20</DataSourceID>

<AliasName>SiM</AliasName>

-5-

<LayerName>SDE.C4SQNROADS</LayerName>

<DescriptionField/>

<LayerType>2</LayerType>

<GeographicalCode>2300</GeographicalCode>

<NameField>NAME</NameField>

<CodeField/>

<ExtendField/>

</Layer>

<Layer>

<GeocodingLayerID>9</GeocodingLayerID>

<DataSourceID>20</DataSourceID>

<AliasName>^it</AliasName>

<LayerName>SDE.C4SQPROADS</LayerName>

<DescriptionField/>

<LayerType>2</LayerType>

<GeographicalCode>2300</GeographicalCode>

<NameField>NAME</NameField>

<CodeField/>

<ExtendField/>

</Layer>

2.请求URL二

请求响应

（略）

3.请求URL三

请求响应

（略）

-6-

5正向地理编码服务接口

5.1接口索引

序号服务接口功能说明

1FindAddress获取地名地址信息.

2FindAddressByName由给定关键字获取地名地址信息。

3FindAddressByGeometrjf由给定空间信息获取地名地址信息。

5.2请求参数说明

参数必填类型说明

KEY否string地址关键字

FORMAT否string信息返回类型，支持以下类型:xmljsonjavascript

CALLBACK否string请求回调函数,当返回类型为javascript时,此参数

有效

WKT否string请求空间条件WKT描述，当进行地名查询的时候，可以

指定此条件进行属性空间叠加查询

BUFFER否double请求空间条件的缓冲区范围，单位为地图单位，当设置

WKT后此值方能生效

IIASGEOMETRY否bool是否返回几何休信息

LAYERNAME否string查询图层名称，此参数值区分大小写，请地理编码服务

元数据接口获取相关定位图层元数据

CITYCODE否int需要查询的城市标准编码

ADDRESSTYPE否string地名定位类型，分别为：

所有类型［All］、门牌号［DoorPlate］、楼栋号

［Building］

、一般点状地名地址［PointAddress］、道路［Road］、行

政区划［District］

SPATIALRELATIONSHIP否string集合物体空间关系，支持如下类型的查询（当定位类型

为地名点时，此参数无意义）：

Undefined、Intersects、EnvelopelntersectSs

IndcxIntcrsccts、Tcuchcs、Overlaps、CrossesWithin

Contains、Relation

-7-

5.3请求示例

5.3.1地名属性查询

1.请求URL一

请求响应(节选)

<?xmlversion="1.0"encoding="utf-8"?>

<ArrayOfAddress

xmlns：xsi="http:///2001/XMLSchema-instance"

xmlns:xsd="/2001/XMLSchema">

<Address>

vName>北京同仁堂药店有限公司</Name>

<Code>0</Code>

<Type>PointAddrcss</Type>

^GeographicalCode>lTOCX/GeographicalCode^

<GeoGraphicalName/>

〈Description,河坊街143号〈/Description〉

<LayerName>SDE.DRUGSTORE</LayerName>

<ObjectID>2iO</ObjectID>

<DataSourceID>20</DataSourceID>

<Envelope>

<SRID>O</SRID>

<MaxX>40456.6666127</MaxX>

<MaxY>49627.13556778</MaxY>

<MinX>30456.6666127</MinX>

<MinY>39627.13556778v/MinY>

</Envelope>

</Address>

<Address>

vName>北京东易日盛装饰股份有限公司v/Name>

<Code>0</Code>

<Type>PointAddrcss</Type>

<GeographicalCode>270()</GeographicalCode>

<GeoGraphicalName/>

<Description/>

<LayerName>SDE.ENTERPRISEUNITNAME</LayerName>

<ObjectID>7386</ObjectID>

<DataSourceID>20</DataSourceID>

<Envelope>

-8-

<SRID>O</SRID>

<MaxX>84050.17191994</MaxX>

<MaxY>82155.74103988</MaxY>

<MinX>84050.17191994</MinX>

<MinY>82155.74103988</MinY>

</Envelope>

</Address>

<Address>

vName>北京水八零生态科技有限公司v/Name>

<Code>0</Code>

<Type>PointAddrcss</Type>

<GeographicalCode>270(X/GeographicalCode>

<GeoGraphicalName/>

<Description/>

<LayerName>SDE.ENTERPRISEUNITNAME</LayerName>

<ObjectID>6085</ObjectID>

<DataSourceID>20</DataSourceID>

<Envelope>

<SRID>O</SRID>

<MaxX>80827.3880328</MaxX>

<MaxY>80292.0376297</MaxY>

<MinX>80827.3880328</MinX>

<MinY>80292.0376297</MinV>

</Envelope>

</Address>

2.请求URL二

请求响应（节选）

Iterns:0

Name

北京同仁堂药店有限公司

Code0

TypePointAddress

GeographicalCode

2700

GeoGraphica1Name

Description

河坊街143号

LaycrNameSDE.DRUGSTORE

ObjectID210

-9-

DataSourceID

20

EnvelopeSKID0

MaxX8C456.66661

MaxY79627.13557

MinX8C456.66661

MinY7S627.13557

Geometry

Itoms:1

Name

北京东易日盛装饰股份有限公司

Code0

TypePointAddress

GeographicalCode

2700

GeoGraphica1Name

Description

LayerNameSDE.ENTERPRISEUNITNAME

ObjeclID7386

DataSourceID

20

EnvelopeSRID0

MaxX84050.17192

MaxY82155.74104

MinX84050.17192

MinY82155.74104

Geometry

3.请求URL三

请求响应

（略）

5.3.2地名空间查询

1.请求URL一

-10-

请求响应

<?xmlversion="1.0"encoding="utf-8"?>

<ArrayOfAddress

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<Address>

<Name>建国中路209号v/Name>

<Code>330102004063</Code>

<Type>DoorPIatc</Type>

<GeographicalCode>2200</GeographicalCode>

<GeoGraphicalName/>

<Description/>

<LayerName>SDE.HOUSENUMBER</LayerName>

<ObjectID>23991</ObjectID>

<DataSourceID>20</DataSourceID>

<Envelope>

<SRID>O</SRID>

<MaxX>81492.3828116</MaxX>

<MaxY>81485.93750478</MaxY>

<MinX>81492.3828116</MinX>

<MinY>81485.93750478</MinY>

</Envelope>

</Address>

</ArrayOfAddress>

2.请求URL二

请求响应（节选）

<?xmlversion="1.0"encoding="utf-8"?>

<ArrayOfAddress

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<Address>

vName>中山北路143号v/Name>

<Code>330i0300205i</Code>

<Type>Building</Type>

<GeographicalCode>2200</GeographicalCode>

<GeoGraphicalName/>

-ii-

<Description/>

<LayerName>SDE.FL()ORNUMBER</LayerName>

<ObjectID>779</ObjectID>

<DataSourceID>20</DataSourceID>

<Envelope>

<SRID>O</SRID>

<MaxX>80378.92968912</MaxX>

<MaxY>82039.9687505</MaxY>

<MinX>80378.92968912</MinX>

<MinY>82039.9687505</MinY>

</Envelope>

</Address>

<Address>

vName>中山北路123号v/Name>

<Code>330l03002051</Code>

<Type>Building</7ype>

<GeographicalCode>2200</GeographicalCode>

<GeoGraphicalName/>

<Description/>

<LayerName>SDE.FLOORNUMDER</LayerName>

<ObjectID>780</ObjectID>

<DataSourceID>20</DataSourceID>

<Envelope>

<SRID>0</SRID>

<MaxX>80387.14062127</MaxX>

<MaxY>81969.82031009</MaxY>

<MinX>80387.14062127</MinX>

<MinY>81969.82031009</MinY>

</Envelope>

</Address>

<Address>

vName>华景北苑26®</Name>

<Code>330104005062</Code>

<Type>Building</Type>

<GeographicalCode>220(X/GeographicalCode>

<GeoGraphicalName/>

<Description/>

<LayerName>SDE.FLOORNUMBER</LayerName>

<ObjectID>3517</ObjectID>

<DataSourceID>20</DataSourceID>

<Envelope>

<SRID>0</SRID>

<MaxX>82460.06250655</MaxX>

<MaxY>82768.95311908</MaxY>

-12-

<MinX>82460.06250655v/MinX>

<MinY>82768.95311908</MinY>

</Envelope>

</Address>

3.请求URL三

请求响应（节选）

<?xmlversion="1.0"encoding="utf-8"?>

<ArrayOfAddress

xmlns：xsi="http://www./2001/XMLSchema-instance"

xmlns:xsd="/2001/XMLSchema">

<Address>

vName>中山北路143号v/Name>

VCode>330103002051</Code>

<Type>Building</Type>

<GeographicalCode>2200</GeographicalCode>

<GeoGraphicalName/>

<Description/>

<LayerName>SDE.FLOORNUMBER</LayerName>

<ObjectID>779</ObjectID>

<DataSourceID>20</DataSourceID>

<Envelope>

<SRID>O</SRID>

<MaxX>80378.92968912</MaxX>

<MaxY>82039.9687505</MaxY>

<MinX>80378.92968912</MinX>

<MinY>82039.9687505</MinY>

</Envelope>

<Geometry>

<SRID>O</SRID>

<WKT>POINT(80378.9296891282039.9687505)</WKT>

<Buffer〉。〈/Buffer〉

</Geometry>

</Address>

<Address>

vName>中山北路123号v/Name>

<Code>330103002051</Code>

<Type>Building</Type>

<GeographicalCode>2200</GeographicalCode>

<GeoGraphicalName/>

-13-

<Description/>

<LayerName>SDE.FLOORNUMBER</LayerName>

<ObjectID>780</ObjectID>

<DataSourceID>20</DataSourceID>

6逆向地理编码服务接口

6.1接口索引

序号服务接口功能说明

1ReverscGcocode由给定位置点进行地理反编码。

2ReverseGecxrodeByType由给定位置点和反编码类型进行地理反编码。

6.2请求参数说明

参数必填类型说明

X否double需要进行地理反编码的地理X坐标

Y否double需要进行地理反编码的地理Y坐标

FORMAT否string信息返回类型，支持以下类理：xmljsonjavascripthtml

CALLBACK否string请求回调函数,当返回类型为javascript时,此参数有效

HASGEOMETRY否bojl是否返回几何体信息

ADDRESSTYPE否string地名定位类型，分别为：

所有类型［All］、门牌号［DoorPlate］、楼栋号［Building］、

一般点状地名地址［PointAddress］、道路［Road］、行政区划

［District］

6.3请求示例

6.3.1地名属性查询

1.请求URL一

-14-

请求响应(节选)

<?xmlversion="1.0"encoding="utf-8"?>

<ArrayOfAddress

xmlns：xsi="http://www.w3.org/2001/XMLSch