Mapbox.js is no longer in active development. To learn more about our newer mapping tools see Mapbox GL JS.

Use geocoder to set map position

Using the Mapbox Geocoding API initially set map position on Chester, New Jersey.

<!DOCTYPE html>
<meta charset=utf-8 />
<title>Use geocoder to set map position</title>
<meta name='viewport' content='initial-scale=1,maximum-scale=1,user-scalable=no' />
<script src='https://api.mapbox.com/mapbox.js/v3.3.1/mapbox.js'></script>
<link href='https://api.mapbox.com/mapbox.js/v3.3.1/mapbox.css' rel='stylesheet' />
  body { margin:0; padding:0; }
  #map { position:absolute; top:0; bottom:0; width:100%; }
<div id='map'></div>
L.mapbox.accessToken = '<your access token here>';
var geocoder = L.mapbox.geocoder('mapbox.places');

var map = L.mapbox.map('map')

geocoder.query('Chester, NJ', showMap);

function showMap(err, data) {
    // The geocoder can return an area, like a city, or a
    // point, like an address. Here we handle both cases,
    // by fitting the map bounds to an area or zooming to a point.
    if (data.lbounds) {
    } else if (data.latlng) {
        map.setView([data.latlng[0], data.latlng[1]], 13);
to create your own custom map and use it in this example.
Use this example by copying its source into your own HTML page and replacing the Map ID with one of your own from your projects. Having trouble with JavaScript? Try out Codecademy or contact our support team.
Copy example