Programming MapPoint in .NET

Chapter 6. MapPoint Web Service Find APIs

The Find Service is one of the four core components of the MapPoint Web Service, allowing you to find places, addresses, points of interest around a given place or address, locations based on entity types, and so on. In this chapter, we’ll take an in-depth look at the MapPoint Web Service Find APIs .

Understanding Find APIs

If you remember from our discussion in Chapter 5, the Find Service endpoint is located at the FindService.asmx, and the APIs available for Find Service are exposed via the FindServiceSoap class in the Web Service proxy (Reference.cs or Reference.vb). The FindServiceSoap class contains a number of find-related methods used for finding places, addresses, nearby points, and so on. Table 6-1 shows the methods exposed on the FindServiceSoap class.

Table 6-1. Methods available on the FindServiceSoap class

Method	Description
Find	Finds geographic locations in a specified data source based on a place name. Returns an array of results as a FindResults object. Maximum returned values is 500. Default number of returned results is 25.
FindAddress	Finds geographic locations in a specified data source based on an address. Returns an array of possible results as a FindResults object. Maximum returned values is 100. Default number of returned results is 25.
FindByID	Finds points of interest based on entity ID. The found results are returned as a FindResults object.
FindByProperty	Finds points of interest based on predefined ...