Syntax
long PCMSLatLongsEnRoute(Trip trip, double* latlong, long numPairs)
Parameters
Trip trip – Handle to a trip.
double* latlong – An array of pairs of latitude/longitude coordinates along the given trip. Must point to a buffer large enough to hold 2*numPairs*sizeof(double). If NULL is passed as the latlong parameter, the function simply returns the total number of pairs.
long numPairs – Used to limit the number of coordinates returned in the latlong array, based on the actual number of points of the given trip.
Description
Retrieves a sequence of latitudes/longitudes along a trip. Best practice for this API is to call PCMSLatLongsEnRoute with latlong as NULL first in order to determine the number of actual points along the trip.
Return Values
Sample Code
ret = PCMSLatLongsEnRoute(trip, NULL, 0, TRUE);
if (ret > 0)
{
double* pLatLongs = new double[2*ret];
ret = PCMSLatLongsEnRoute(trip, pLatLongs, ret, TRUE);
printf(" %d latlongs found...", ret);
}
Supported Since: PC*MILER Connect 12
Category: Trip Management