The function finds the nearest POI around given position. The POI may be from the original map POIs or it may be a custom POI.
- Parameters
-
| lpError | Additional error information returned from Drive. |
| lpPoi | Returned SPoi class containing information about the found POI. |
| 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 dwCategory=PoiService.USERDEFINE it is necessary to define also strCategory. 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