JavaScript/jQuery Map Options

The value of this option will be passed to the accesskey attribute of the HTML element that underlies the widget.

This option is used when the widget is displayed on a platform whose guidelines include the active state change for widgets.

If autoAdjust is enabled, zoom is set to the maximum value allowing all markers and routes to be displayed at the same time. The center is changed so that markers and routes are aligned with the widget's center. Set the autoAdjust option to false to disable this behavior.

Note that the zoom level can only be automatically decreased to display all markers and routes. If the current zoom level allows all routes and markers to be displayed on the map, it remains unchanged.

You can specify the center value in one of the following formats:

• { lat: 40.749825, lng: -73.987963}
• "40.749825, -73.987963"
• [40.749825, -73.987963]
• 'Brooklyn Bridge,New York,NY'

When you use the Map as an ASP.NET MVC Control, this option accepts either a string value indicating the address, or two double type values indicating the coordinates.

@(Html.DevExtreme().Map()
    .Center("Brooklyn Bridge,New York,NY")
    // ===== or =====
    .Center(40.74982, -73.987963)
)

@(Html.DevExtreme().Map() _
    .Center("Brooklyn Bridge,New York,NY") _
    ' ===== or =====
    .Center(40.74982, -73.987963)
)

Assign a Boolean value to this option to enable or disable all controls at once - both the map navigation control and the map type control.

You can configure this option in an ASP.NET MVC Control as follows:

@(Html.DevExtreme().WidgetName()
    .ElementAttr("class", "class-name")
    // ===== or =====
    .ElementAttr(new {
        @id = "elementId",
        @class = "class-name"
    })
    // ===== or =====
    .ElementAttr(new Dictionary<string, object>() {
        { "id", "elementId" },
        { "class", "class-name" }
    })

)

@(Html.DevExtreme().WidgetName() _
    .ElementAttr("class", "class-name")
    ' ===== or =====
    .ElementAttr(New With {
        .id = "elementId",
        .class = "class-name"
    })
    ' ===== or =====
    .ElementAttr(New Dictionary(Of String, Object) From {
        { "id", "elementId" },
        { "class", "class-name" }
    })
)

This option accepts a value of one of the following types:

• Number
  The height in pixels.

• String
  A CSS-accepted measurement of height. For example, "55px", "80%", "auto", "inherit".

• Function
  A function returning either of the above. For example:

  JavaScript

  height: function() {
      return window.innerHeight / 1.5;
  }

This option can hold a string representing an authentication key of a certain provider. In addition, this option can hold an object with specified keys for every used provider: { bing: BINGAPIKEY, google: GOOGLEAPIKEY, googleStatic: GOOGLESTATICAPI_KEY}.

For more information on authentication keys, see the required map provider documentation.

To set a custom icon for an individual marker, specify the iconSrc field of the corresponding marker data source object.

View Demo

If you use the Knockout approach when working with the Map widget, you can pass an observable array to the markers option to easily manage markers.

View Demo

Assign a function to perform a custom action when the map is clicked.

To navigate to a specific URL when the click event fires, assign that URL or the anchor part (#) of that URL directly to this option as a string.

You cannot access widget elements in this handler because it is executed before they are ready.

Assign a function to perform a custom action after a marker is added to the map.

Assign a function to perform a custom action after a marker is removed from the map.

Assign a function to perform a custom action after a map is rendered.

Assign a function to perform a custom action after a route is added to the map.

Assign a function to perform a custom action after a route is removed from the map.

Use the "googleStatic" provider to connect route points directly rather than by following the street layout.

When using the widget as an ASP.NET MVC Control, specify this option using the GeoMapProvider enum. This enum accepts the following values: Bing, Google, and GoogleStatic.

View Demo

View Demo

When this option is set to true, the widget text flows from right to left, and the layout of elements is reversed. To switch the entire application/site to the right-to-left representation, assign true to the rtlEnabled field of the object passed to the DevExpress.config(config) method.

DevExpress.config({
    rtlEnabled: true
});

See Also

• Right-to-Left Support Demo: DataGrid | Navigation Widgets | Editors

The value of this option will be passed to the tabindex attribute of the HTML element that underlies the widget.

The available option values are based on map types supported by the Google map provider. If you use the Bing map, the widget casts the option value to the appropriate value supported by the "Bing" provider.

• hybrid -> Aerial
• roadmap -> Road

When using the widget as an ASP.NET MVC Control, specify this option using the GeoMapType enum. This enum accepts the following values: Hybrid, Roadmap and Satellite.

View Demo

This option accepts a value of one of the following types:

• Number
  The width in pixels.

• String
  A CSS-accepted measurement of width. For example, "55px", "80%", "auto", "inherit".

• Function
  A function returning either of the above. For example:

  JavaScript

  width: function() {
      return window.innerWidth / 1.5;
  }