Mapbox REST API

API Endpoints

Code Examples

# Forward geocoding example
curl "https://api.mapbox.com/geocoding/v5/mapbox.places/Los%20Angeles.json?access_token=pk.eyJ1IjoieW91cnVzZXJuYW1lIiwiYSI6InlvdXJ0b2tlbiJ9"

# Get driving directions
curl "https://api.mapbox.com/directions/v5/mapbox/driving/-122.42,37.78;-77.03,38.91?access_token=pk.eyJ1IjoieW91cnVzZXJuYW1lIiwiYSI6InlvdXJ0b2tlbiJ9&geometries=geojson&steps=true"

// Forward geocoding with fetch
const accessToken = 'pk.eyJ1IjoieW91cnVzZXJuYW1lIiwiYSI6InlvdXJ0b2tlbiJ9';
const query = 'San Francisco';

fetch(`https://api.mapbox.com/geocoding/v5/mapbox.places/${encodeURIComponent(query)}.json?access_token=${accessToken}`)
  .then(response => response.json())
  .then(data => {
    const coordinates = data.features[0].geometry.coordinates;
    console.log('Coordinates:', coordinates);
  })
  .catch(error => console.error('Error:', error));

// Get directions
const coordinates = '-122.42,37.78;-77.03,38.91';
fetch(`https://api.mapbox.com/directions/v5/mapbox/driving/${coordinates}?access_token=${accessToken}&geometries=geojson`)
  .then(response => response.json())
  .then(data => {
    const route = data.routes[0];
    console.log('Duration:', route.duration, 'seconds');
    console.log('Distance:', route.distance, 'meters');
  });

import requests

# Configuration
access_token = 'pk.eyJ1IjoieW91cnVzZXJuYW1lIiwiYSI6InlvdXJ0b2tlbiJ9'
base_url = 'https://api.mapbox.com'

# Forward geocoding
query = 'New York City'
geocoding_url = f'{base_url}/geocoding/v5/mapbox.places/{query}.json'
params = {'access_token': access_token}

response = requests.get(geocoding_url, params=params)
data = response.json()
coordinates = data['features'][0]['geometry']['coordinates']
print(f'Coordinates: {coordinates}')

# Get directions
coordinates = '-122.42,37.78;-77.03,38.91'
directions_url = f'{base_url}/directions/v5/mapbox/driving/{coordinates}'
params = {
    'access_token': access_token,
    'geometries': 'geojson',
    'steps': 'true'
}

response = requests.get(directions_url, params=params)
data = response.json()
route = data['routes'][0]
print(f"Duration: {route['duration']} seconds")
print(f"Distance: {route['distance']} meters")

Related APIs