FindNearbyPoi() [2/2]

static int FindNearbyPoi ( out SError  Error, out SPoi []  Pois, ref Int32  ListSize, Int32  CategoryNumber, string  strCategoryName, int  lX, int  lY, Int32  MaxTime  )

inlinestatic

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

Error	Additional error information returned from Drive.
Pois	Returned array of SPoi classes containing information about the found POIs.
ListSize	Number of POIs to return.
CategoryNumber	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.
strCategoryName	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.
MaxTime	Maximum time (in milliseconds) function can take. If MaxTime=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.

References SError.SizeOf().