PCMSGetFmtMatch4

Syntax

int PCMSGetFmtMatch4(
  Trip trip,
  int which,
  char *addrBuf,
  int addrLen,
  char *cityBuf,
  int cityLen,
  char *stateBuf,
  int stateLen,
  char *zipBuf,
  int zipLen,
  char *countyBuf,
  int countyLen,
  double *latitude,
  double *longitude
)

Parameters

• Trip trip – Handle to a trip.
• int which – The index number of the matching location in the pick list returned by PCMSLookup. The first match in the list is index 0.
• *char addrBuf – The buffer where the address will be deposited.
• int addrLen – The length of the address field.
• *char cityBuf – The buffer where the city name will be deposited.
• int cityLen – The length of the city field.
• *char stateBuf – The buffer where the state name will be deposited.
• int stateLen – The length of the state field.
• *char zipBuf – The buffer where the ZIP code will be deposited.
• int zipLen – The length of the ZIP code field.
• *char countyBuf – The buffer where the county will be deposited.
• int countyLen – The length of the county field.
• *double latitude – The location’s latitude.
• *double longitude – The location’s longitude.

Description

Gets and formats a location name from a list of matches created using PCMSLookup. It contains a different string for each piece of information regarding address, city, state, ZIP code, and county. It also returns the location’s decimal latitude and longitude. (A license for the Streets add-on is required for address information.)

Return Values

See Standard Returns in the Connect API documentation.

Supported Since: PC*Miler Connect 28

Category: Geocoding