Geocode an addressTurn an address, postcode or place name into latitude and longitude, plus a cleaned-up standard address and every layer around it - street, neighborhood, city, postcode, region and country, each as its own field. Use it to put a spreadsheet of addresses on a map, to normalise addresses typed by hand, or to get the coordinates the routing actions need.
Find the address at a pointTurn latitude and longitude into the address and place names at that spot - the street address, and the neighborhood, city, postcode, region and country containing it. Use it to label GPS readings, delivery pings or map clicks with somewhere a person can read.
Geocode a list of addressesGeocode many addresses at once - a spreadsheet column, a list of branches, the results of an earlier step. Every address given comes back in the order it was sent, matched or not, each beside the text it was looked up under, and the counts say how many matched. Far cheaper and faster than geocoding each address in a loop.
Search for placesSearch for businesses, landmarks and addresses by name - 'Blue Bottle Coffee', 'Heathrow Terminal 5', 'pharmacy'. Returns each place's coordinates, full address, categories, phone number, website and opening hours, and can be limited to places open right now.
Find nearby places by categoryList every place of one kind near a location - all the cafes, every hotel, the nearest petrol stations. Returns up to 25 places with their coordinates, address, phone number, website, opening hours and how far away they are. The category is picked from Mapbox's own live list.
List place categoriesEvery category the category search accepts, with the id to pass and the name it goes by. Useful to check what Mapbox calls something before filtering on it, or to let a later step choose a category for itself.
Get directionsRoute between two points, optionally through stops on the way. Returns the distance, the travel time, turn-by-turn instructions, and a leg-by-leg breakdown between stops. Driving routes use live traffic by default, can avoid tolls, motorways, ferries or unpaved roads, and can be asked for a departure or arrival time to get a prediction for then instead of now.
Get travel times between many pointsTravel time and distance from every origin to every destination, in one request. This is what answers 'which of our depots is closest to each customer', 'which technician should take this job', or 'which of these flats are within 20 minutes of the office'. Results come back both as a grid and as one row per pair, which is the form a filter or a sort can read.
Get the area reachable in a given timeThe area you can reach from a point within a set travel time - an isochrone. Use it to draw a delivery or service zone, to show a 15-minute walk from a shop, or as a catchment to test addresses against. Returns one outline per travel time asked for, largest first, as GeoJSON polygons ready to draw on a map.
Put stops in the fastest orderGiven a set of stops, work out the quickest order to visit them all - the travelling-salesman problem, solved. This is what turns an unordered list of deliveries, service calls or viewings into a route sheet. Returns the stops in visiting order along with the total distance and time.
