CGI Advantage Initialization Parameters

The CGI Advantage system initialization file, ADV30Params.ini, contains initialization parameters that are used by CGI Advantage. This topic includes details on the parameters that relate to the Travel and Expense Management area along with a brief description for each parameter.

Map Service ParameterMap Service Parameter

Parameter

Description

MapService

Valid values are GoogleMaps or MapQuest. The default value is GoogleMaps. This parameter indicates whether the application should use Google Maps or MapQuest API. If MapQuest is selected, then refer to the parameters listed in the “MapQuest Parameters” section of this topic. If GoogleMaps is selected, then refer to the “Google Maps Parameters” section of this topic.

MapQuest ParametersMapQuest Parameters

The following parameters are only used if the MapService parameter is MapQuest.

Parameter

Description

MapQuestEnterpriseKey

This is a required parameter to capture the MapQuest license key. This parameter can also be used to specify open license keys for use with Advantage for internal testing or other less formal environments.

MapQuestGeocodingURL

This parameter captures the Geocoding URL. When using an enterprise license key, use https://www.mapquestapi.com/. Refer https://www.mapquestapi.com/geocoding for details. When using an open license key, use https://open.mapquestapi.com/. Refer https://open.mapquestapi.com/geocoding for details.

MapQuestGeocodingOptions

This is a required parameter that allows filtering addresses by how specific the address should be. The following first two characters of the MapQuest Quality Code describe the type of location:

  • P1 A specific point location

  • L1 A specific street address location

  • I1 An intersection of two or more streets

  • B1-B3 The center of a single street block

  • A1 Administrative area; for USA, a country

  • A3 Administrative area; for USA, a state

  • A4 Administrative area; for USA, a county

  • A5 Administrative area; for USA, a city

  • A6 Administrative area

  • Z1-Z4 Postal code

Required: L1 (specific address)

Recommended: I1, P1 (allows for precise distance calculation)

Optional: A5, A6, B1, B2, B3, Z1, Z2, Z3, Z4 (less meaningful for distance)

Not recommended: A1, A3, A4 (not meaningful for distance)

MapQuestReverseURL

This parameter captures the Reverse route request URL – searching by latitude/longitude instead of location. When using an enterprise license key, use https://www.mapquestapi.com/. Refer https://www.mapquestapi.com/reverse for details. When using an open license key, use https://open.mapquestapi.com/. Refer https://open.mapquestapi.com/reverse for details.

MapQuestRouteURL

This parameter captures the Route request URL. When using an enterprise license key, use https://www.mapquestapi.com/. Refer https://www.mapquestapi.com/directions for details. When using an open license key, use https://open.mapquestapi.com/. Refer https://open.mapquestapi.com/directions for details.

MapQuestRouteOptions

This parameter captures the Route request parameters. When using an enterprise license key, Refer https://www.mapquestapi.com/directions for details. When using an open license key, Refer https://open.mapquestapi.com/directions for details. Ensure this value is URL encoded (spaces are prohibited).

MapQuestProxyServerURL

This parameter is optional. If a proxy server is required for the Advantage server to connect to the Internet, then this parameter provides the URL of the proxy server to be used for access to MapQuest.

MapQuestProxyServerPort

This parameter is required if the MapQuestProxyServerURL parameter is populated.

MapQuestAutoSuggestURL

Required if your site uses the auto suggest feature of MapQuest.

Google Maps ParametersGoogle Maps Parameters

The following parameters are only used if the MapService parameter is GoogleMaps.

Parameter

Description

GoogleMapsEnterpriseKey

Captures a valid Google Maps license key.

GoogleMapsGeocodingURL

Captures the Geocoding request URL.

Refer https://developers.google.com/maps/documentation/geocoding/overview for details.

GoogleMapsReverseURL

Reverse (by Lat/Long) Request URL

Refer https://developers.google.com/maps/documentation/geocoding/overview for details.

GoogleMapsRouteURL

Route Request URL

Refer https://developers.google.com/maps/documentation/geocoding/overview for details.

GoogleMAPsScriptURL

Google Map Scripts URL

Required if using Google Map Service.