int PCMSGetFPARPOICategoryName(PCMServerID serv, int poiCatIndex, char *buffer, int bufSize)


PCMServerID serv – The PC*MILER server ID.

int poiCatIndex  Index of the POI category.

char *buffer – Empty string buffer that will be filled with the name of the POI category.

int bufSize – The number of bytes in the buffer.


Gets the name of a specific Place of Interest (POI) category based on an index value when you find POIs along a route (FPAR). 

The index starts at 0 with Custom Place Sets created in Content Tools and synced with PC*MILER. (i.e. If you have five Place Sets, those categories will occupy index Nos. 0-4). The remaining index numbers are generic Place categories in PC*MILER, including Rest Areas, Truck Stops, etc. Use PCMSGetNumFPARPOICategories to get the total number of categories.

Return Values 

A negative one (-1) indicates an error has occurred. Zero or greater indicates success and the number of characters put into the buffer.


Sample Code 

PCMSGetFPARPOICategoryName(server, i, buffer, BUFLEN);
printf("%d %s", i, buffer);

Supported Since: PC*MILER Connect 29

Category: Find Places Along Route (FPAR)