StraTopo - Isochrone API

Expand your platform’s capabilities with a quick and easy Isochrone API integration

Simple implementation in your platform
Travel time isochrones available at the touch of a button
Easy to integrate own data or other external data

Subscribe now!

API Specification

Code example

Gain more location-based insights with the help of the StraTopo API

Code example:

The Isochrone API can be accessed through an HTTP POST request to the following endpoint:

Copy to Clipboard

The request header should look like:

Copy to Clipboard

where AUTH_KEY stands for your personal API key. Don’t have one yet? Contact us to help you get started.

Your request body should be a JSON containing the specifications for the isochrones you wish to generate. Currently, only a single starting location can be entered, but multiple travel durations can be set in the same request. The supported specifications are:

latitude, longitude: the coordinates of the starting location,
minutes: an array of travel durations in minutes,
modality: the modality to be used for travel around the starting location. Walking and biking are currently supported.

(See our OpenAPI documentation as well for all the details.) The request response will be a GeoJSON containing a polygon for each item in the minutes array, ready for use in your own applications.

The following example demonstrates how in a few lines of code the request can be made in Javascript and visualised on an interactive map with the Leaflet library.

Copy to Clipboard

<!DOCTYPE html>
<html>

<link rel="stylesheet" href="https://unpkg.com/leaflet@1.7.1/dist/leaflet.css" integrity="sha512-xodZBNTC5n17Xt2atTPuE1HxjVMSvLVW9ocqUKLsCC5CXdbqCmblAshOMAS6/keqq/sMZMZ19scR4PsZChSR7A==" crossorigin=""/>
	    <script src="https://unpkg.com/leaflet@1.7.1/dist/leaflet.js" integrity="sha512-XQoYMqMTK8LvdxXYG3nZ448hOEQiglfqkJs1NOQV44cWnUrBc8PkAOcXy20w0vlaXaVUearIOBhiXZ5V3ynxwA==" crossorigin=""></script>

</style>
	</head>
	
	<body>
		
		<div id="map"></div>

<script>

// Define the styling of an isochrone.
			const isochroneStyle = {'fillColor': '#1C7B34'};
			
			// Define the coordinates of the starting location. In this example we chose the Vrijthof public square in Maastricht.
			const latitude = 50.849266;
			const longitude = 5.688527;
		
			// Initialise the Leaflet map, centered around the starting location.
			let map = new L.map('map').setView([latitude, longitude], 15);

// Define a marker at the starting location.
			let marker = new L.marker([latitude, longitude]);
		
			// Define a tile layer.
			let layer =
				new L.tileLayer(
					'https://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}{r}.png',
					{
						attribution: '© <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors © <a href="https://carto.com/attributions">CARTO</a>',
						maxZoom: 18
					}
				);

// Add the marker and tile layer to the map.
			marker.addTo(map);
			map.addLayer(layer);

// Make a POST request to the StraTopo Isochrone API to generate isochrones and add the GeoJSON response to the map.
			fetch(
				'https://api.routing.stratopo.nl/api/v1/polygon',
				{
					method: 'POST',
					headers:
						{
							'Content-Type': 'application/json',
							'Authorization': 'AUTH_KEY' // Replace with your own API key.
						},
					body:
						JSON.stringify({
							'latitude': latitude,
							'longitude': longitude,
							'minutes': [5, 10], // Travel durations in minutes.
							'modality': 'walk' // Modality used for travel.
						})
				}
			).then(
			  res => res.json()
			).then(
			  data => L.geoJSON(data, {style: isochroneStyle}).addTo(map)
			)
		
		</script>
	</body>
</html>

After saving this as an HTML file and opening it in a browser you will get this isochrone shape: