Siebel Field Service Guide > Business Service Methods in Siebel Field Service > Business Service Methods for the Dispatch Board >

CalculateDistanceVals Method

CalculateDistanceVals calculates the distance between the new activity location and the employee location, and produces a list of employee ID and distance value pairs. CalculateDistanceVals is the second method that GetCalculatedDistanceVals calls. For more information, see GetCalculatedDistanceVals Method.

This method checks the City, State, and Postal Code fields of an address for matching entries in the ZIP Code business component. You can view the master list of geocodes in the ZIP Code Administration view of the Administration - Data screen. All 3 fields (City, State, and Postal Code) must match exactly to return the latitude and longitude location values used in the distance calculation. This calculation determines the straight line distance between the 2 ZIP Codes using the latitude and longitude coordinates for the 2 ZIP Codes.

This method returns a distance of -1 to alert users when there is no valid result from the data provided. Typically, invalid results occur because of a missing address or unmapped ZIP Code.