--- layout: api title: "v1.6.2 API: L.mapbox.map(element, id|url|tilejson, options)" categories: api version: v1.6.2 permalink: /api/v1.6.2/l-mapbox-map --- {% raw %}

## L.mapbox.map(element, id|url|tilejson, options)

Create and automatically configure a map with layers, markers, and interactivity.

Extends: `L.Map`

Options | Value | Description
--- | --- | ---
element (required) | string | Must be the id of an element, or a DOM element reference.
id or url or tilejson | string if id or url object if tilejson | url can be a map `id` string `examples.map-foo` a URL to TileJSON, like `http://a.tiles.mapbox.com/v3/examples.map-0l53fhk2.json` a TileJSON object, from your own Javascript code
options | object | If provided, it is the same options as provided to L.Map with the following additions: `tileLayer` L.TileLayer options. Options passed to a `L.mapbox.tileLayer` based on the TileJSON. Set to `false` to disable the `L.mapbox.tileLayer`. `featureLayer` `L.mapbox.featureLayer` options. Options passed to a `L.mapbox.featureLayer` based on the TileJSON. Set to `false` to disable the `L.mapbox.featureLayer`. `gridLayer` `L.mapbox.gridLayer`. Options passed to a `L.mapbox.gridLayer` based on the TileJSON. Set to `false` to disable the `L.mapbox.gridLayer`. `legendControl` `L.mapbox.legendControl` options. Options passed to a `L.mapbox.legendControl` based on the TileJSON. Set to `false` to disable the `L.mapbox.legendControl`. `shareControl`: Options passed to a `L.mapbox.shareControl`. Set to `false` to disable the `L.mapbox.shareControl`. `infoControl`: Options passed to a `L.mapbox.infoControl`. Set to `false` to disable the `L.mapbox.infoControl`.

Example:

    // map refers to a <div> element with the ID map
    // examples.map-4l7djmvo is the ID of a map on Mapbox.com
    var map = L.mapbox.map('map', 'examples.map-4l7djmvo');

    // map refers to a <div> element with the ID map
    // This map will have no layers initially
    var map = L.mapbox.map('map');

Returns: a map object

### map.getTileJSON()

Returns this map's TileJSON object which determines its tile source, zoom bounds and other metadata.

Returns: the TileJSON object

{% endraw %}