The function finds the defined number of nearest POIs around given position. The POIs may be from the original map POIs or they may be some custom POIs.
- Parameters
-
| lpError | Additional error information returned from Drive. |
| lpPoiList | Returned array of SPoi classes containing information about the found POIs. |
| nListSize | Number of POIs to return. |
| dwCategoryNumber | Category ID. If this value is filled with standard value, original POIs are found. Set to PoiService.USERDEFINE for custom POI. Possible values are enumerated in PoiService enum. |
| lpszCategoryName | Custom POI category name, if custom POI is searched. |
| lX | X-coordinate of place, where to search. |
| lY | Y-coordinate of place, where to search. |
| dwMaxTime | Maximum time (in milliseconds) function can take. If dwMaxTime=0 function execution is not time limited. |
- Returns
- 1 if successful, other value otherwise.
Distance between taken position and POI is computed bee-line.
If dwCategoryNumber=PoiService.USERDEFINE it is necessary to define also lpszCategoryName. Otherwise category name is obtained from category ID.
X and Y coordinates are geographical longitude and latitude in degrees multiplied by 100000.
See Coordinates conversion section in TROUBLESHOOTING page.
Possible error codes returned from Drive are:
- 0 - Function not succeeded.
- 1 - Function succeeded.
- 2 - Drive not succeeded.
- 3 - Function reached timeout.
1.8.13