MapPoint Web Service Find APIs (Page 1 of 4 )
This article, the first part of a five-part series, discusses the Find Service, one of the four core components of the MapPoint Web Service. It is excerpted from chapter six of the book
Programming MapPoint in .NET, written by Chandu Thota (O'Reilly; ISBN: 0596009062). Copyright © 2007 O'Reilly Media, Inc. All rights reserved. Used with permission from the publisher. Available from booksellers or direct from O'Reilly Media.
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 FindServiceSoapclass in the Web Service proxy (Reference.cs or Reference.vb). TheFindServiceSoapclass 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 theFindServiceSoapclass.
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 aFindResultsobject. 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 aFindResultsobject. 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 aFindResults object. |
| FindByProperty | Finds points of interest based on predefined or custom properties. This method is independent of the location information such as distance and latitude/longitude. The found results are returned as aFindResultsobject. |
Table 6-1. Methods available on the FindServiceSoap class (continued)
| Method | Description |
| FindNearby | Finds points of interest within a specified distance of a given latitude and longitude coordinate; returns an array of found points of interest ordered by proximity to a selected point as a FindResultsobject. Maximum returned values is 500. Default number of returned results is 25. |
| FindNearRoute | Finds points of interest within a specified distance from a route. The found results are returned as aFindResultsobject. |
| FindPolygon | Finds polygons in a specified data source, based on aFindPolygonSpecificationobject. The found results are returned as aFindResultsobject. |
| GetLocationInfo | Finds geographic entities and addresses for a specified latitude and longitude coordinate (also known as reverse geocoding). Returns an array of locations (Locationobjects). Maximum returned values is 250. |
| ParseAddress | Parses a specified address string and returns anAddressobject. |
In this chapter, we will go over these methods in detail; first, let’s look at some basic concepts.
Next: The Anatomy of Find Methods >>
More BrainDump Articles
More By O'Reilly Media
|
 This article is excerpted from chapter six of the book Programming MapPoint in .NET, written by Chandu Thota (O'Reilly; ISBN: 0596009062). Check it out today at your favorite bookstore. Buy this book now.
|
|
