• Identifier of added itinerary,
• Empty string ("") if an error occurred. To get the details of the error, use ErrorInfo.

This function is asynchronous: there is no way to find out whether an error was returned by the function.

Name of Map control to use. If this parameter corresponds to an empty string (""), the Map control to which the current event belongs will be used.

Name of Array variable containing the different positions:

• The first element corresponds to the departure point of itinerary.
• The last element corresponds to the arrival point.
• The other array elements represent the intermediate steps of itinerary. This array must contain at least two elements (departure position and arrival position). If you are using the default Google Map license, this array can contain up to 8 intermediate positions (steps). If you are using a "Google Maps API" license key, the number of intermediate positions is unlimited.

This array must contain two elements (departure position and arrival position). You cannot specify the different steps of the itinerary.

This array can be:

• an array of character strings, describing the address corresponding to each itinerary position. For example: Avenue des Champs Elysée, Paris, France.
  Using a character string is not recommended with the mapping service of Bing Map. The positions can be inconsistent.
• an array of Address variables, describing the address corresponding to each position of the itinerary.
• an array of geoPosition variables, indicating the geographical position corresponding to each itinerary position.
• an array of Marker variables, representing each itinerary position on the map (the markers will be automatically added to the Map control if not already added).

Mode for calculating the itinerary. This parameter can take one of the following values:

itineraryCar (Default value)	The itinerary will be drawn taking into account the roads accessible to cars. Characteristics of this mode: This mode uses Google's geolocation mode. An Internet access is required. You can rearrange the order of the stops get the best possible route.
Versions 21 and later itineraryCarNotOptimized New in version 21 itineraryCarNotOptimized itineraryCarNotOptimized	The itinerary will be drawn taking into account the roads accessible to cars. Characteristics of this mode: This mode uses Google's geolocation mode. An Internet access is required. The order of the stops will not be changed. This constant is not available.
itineraryCyclist	The itinerary will be drawn by respecting the ways accessible to the bicycles. The itineraries for cyclists are not available in all the countries. See the documentation about the geo-localization service of Google for more details. Characteristics of this mode: This mode uses Google's geolocation mode. An Internet access is required. You can rearrange the order of the stops get the best possible route. This constant is not available.
itineraryManual	The itinerary will be drawn in a straight line between each specified position while ignoring the roads. This mode is not necessarily using the geo-localization mode of Google. In this case, <Positions> must correspond to an array of geoPosition variables or to an array of Marker variables. In this mode, the intermediate steps are taken into account according to the addition order in the array. This constant is not available. Caution: If the browser used is Internet Explorer 4, the <Positions> parameter must necessarily correspond to an array of geoPosition variables.
itineraryPedestrian	The itinerary will be drawn by respecting the ways accessible to the pedestrians. Characteristics of this mode: This mode uses Google's geolocation mode. An Internet access is required. You can rearrange the order of the stops get the best possible route. This constant is not available.

Color for drawing the itinerary. This color can correspond to:

• an RGB color (returned by RGB),
• an HSL color (returned by HSL),
• a preset color of WLanguage.

Percentage of opacity for drawing the itinerary.

• 0: transparent drawing,
• 100: no opacity. This parameter is set to 60 by default.

This parameter is not available.

Thickness (in pixels) for drawing the itinerary. The thickness is set to 8 pixels by default.

This parameter is not available.