WebService之MapPoint

 接口的设计是Web Service的核心，设计良好的接口不仅可以减少用户开发的难度，而且可以提高网络交互的效率。为了减少网络交互的数量，我们应尽量设计大颗粒度的接口，下面我们来看看MapPoint Web Service是怎么设计的。

MapPoint Web Service主要包括四大服务：common，find，render，route。此外，还有一个Curstomer Data Service，用来管理用户数据。

1 Common Service
Common Service是其它几个Service的基础，它包括共有和基本的功能。它包含的方法有：

GetCountryRegionInfo：得到国家或区域的名称，ID，经纬度坐标，代码和语言等。

GetDataSourceInfo：得到数据源的名称和其它信息。

GetEntityTypes：得到特定数据源中对象的类型和属性。

GetGreatCircleDistances：得到多个点之间的一组地球大圆距离。

GetVersionInfo：得到MapPoint Web Service的描述名称和相应的版本号。

2 Find Service
Find Service用于对地址、地理对象、热点等的定位。它包含的方法有：

Find：基于查询条件返回一组地理对象。

FindAddress：基于输入地址参数返回一组相关地址。

FindByID：基于对象ID数组返回一组热点。

FindByProperty：基于对象属性值返回一组热点。

FindNearby：根据与选择点的直线距离和对象类型返回一组热点。

FindNearRoute：根据与选择点的路径距离和对象类型返回一组热点。

FindPolygon：返回位于指定区域或包含特定坐标的一组多边形。

GetLocationInfo：根据指定坐标返回一组地址和地理对象。

ParseAddress：解析指定地址字符串返回一个地址对象。

3 Render Service
Render Service用于绘制各种地图、放置热点、绘制多边形区域、设置地图大小和位置以及绘制选择点等。

ConvertToLatLong：把像素坐标转换为经纬度。

ConvertToPoint：把经纬度转换为像素坐标。

GetBestMapView：得到包含所有选定点的最佳地图（比例尺最大）。

GetMap：根据设置参数返回地图图像、视图以及热点区域。

GetLineDriveMap：根据设置参数返回行车地图图像、视图以及热点区域。

4 Route Service
Route Service用于根据地点、起始位置生成路径和驾驶方向地图。

CalculateRoute：根据路段和及其它参数返回路径。

CalculateSimpleRoute：根据指定经纬度坐标返回路径。