Mappoint of WebService

Interface Design is the core of web service. Well-designed interfaces not only reduce the difficulty of user development, but also improve the efficiency of network interaction. To reduce the number of network interactions, we should try our best to design interfaces with a large granularity. Next we will look at how mappoint Web service is designed.

Mappoint web service mainly includes four services: Common, find, render, and route. In addition, there is a curstomer data service used to manage user data.

1 Common Service
Common service is the basis of several other services, including common and basic functions. It includes the following methods:

Getcountryregioninfo: obtains the name, ID, latitude and longitude coordinates, code, and language of the country or region.

Getperformanceinfo: Get the data source name and other information.

Getentitytypes: obtains the object type and attributes of a specific data source.

Getgreatcircledistances: obtains the distance of a group of earth circles between multiple points.

Getversioninfo: Get the description name and version number of the mappoint web service.

2 find service
Find service is used to locate addresses, geographical objects, and hot spots. It includes the following methods:

Find: returns a group of geographic Objects Based on query conditions.

Findaddress: returns a set of related addresses based on the input address parameters.

Findbyid: returns a set of hotspots Based on the Object ID array.

Findbyproperty: returns a set of hotspots Based on Object property values.

Findnearby: returns a set of hot spots based on the linear distance from the selected point and the object type.

Findnearroute: returns a set of Hot Spots Based on the Path Distance from the selected point and the object type.

Findpolygon: returns a group of polygon that are located in the specified area or contain specific coordinates.

Getlocationinfo: returns a group of addresses and geographical objects based on the specified coordinates.

Parseaddress: parses the specified address string and returns an address object.

3 render service
Render service is used to draw various maps, place hotspots, draw polygon areas, set map size and position, and draw multiple choice points.

Converttolatlong: converts pixel coordinates to longitude and latitude.

Converttopoint: converts longitude and latitude to pixel coordinates.

Getbestmapview: Get the best map containing all selected points (maximum scale ).

Getmap: Return map images, views, and hotspot areas based on the set parameters.

Getlinedrivemap: returns the vehicle map image, view, and hotspot Area Based on the set parameters.

4 route Service
Route service is used to generate a path and a driving direction map based on the location and start position.

Calculateroute: return path based on road section and other parameters.

Calculatesimpleroute: return the path based on the specified longitude and latitude coordinates.