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.
A negative one (-1) indicates an error has occurred. Zero or greater indicates success and the number of characters put into the buffer.
memset(buffer,0,BUFLEN); PCMSGetFPARPOICategoryName(server, i, buffer, BUFLEN); printf("%d %s", i, buffer);
Supported Since: PC*MILER Connect 29
Category: Find Places Along Route (FPAR)