30 min isochrone from Philadelphia, PA, United States of America

Isoline API

Isochrones and Isodistances for Location-based Analysis

The Isoline API enables you to analyze the reachability of locations with isochrones and isodistances.

Isolines are lines on a map that connect points of equal value. In the context of the Isoline API, isochrones represent areas that can be reached within a specified travel time. At the same time, isodistances indicate areas that fall within a certain distance from a given point.

Isolines are essential for businesses that rely on postal addresses and locations. They enable companies to optimize operations, streamline logistics, make informed decisions, and enhance customer experiences in delivery, service-based industries, real estate, tourism, hospitality, and more.

Isoline API Live-Demo

Try our Isolines Live demo to see how you can create isochrones for any location of your choice:

  • Simply enter an address or conveniently select a spot directly on the map;
  • Then choose a travel mode from options like drive, truck, bike, hike, walk, or transit;
  • Provide the maximum allowable travel time.

The isochrone shows an area reachable within the provided travel time:

Try out more API parameters to see how they affect the output of isochrones and isodistances with our Isoline API Playground.

Use Cases

The Isoline API offers businesses valuable insights and solutions across various industries. Here are some common questions that the Isoline API can answer for businesses:

  • What areas can be reached within a specific travel time or distance from a given location?
  • How can we optimize service areas to ensure efficient coverage for our operations?
  • What are the accessible regions based on different modes of transportation?
  • Which locations fall within proximity to specific amenities or facilities?
  • What is the best location for a new facility to maximize accessibility for the community?

By utilizing the Isoline API, businesses can find answers to various location-based queries and optimize their operations accordingly. Let's explore some compelling use cases where the Isoline API proves its efficacy and delivers tangible benefits across different branches and sectors:

  • Delivery Service Optimization: By utilizing isochrones and isodistances, businesses can identify areas that fall within specific travel times or distances, enabling them to optimize their delivery routes, reduce costs, and improve overall efficiency.
  • Service Coverage Analysis: Service-based businesses, such as home services or maintenance providers, can use isolines to determine regions within a desired travel time or distance radius. This information helps in planning operations and ensuring effective coverage.
  • Retail Store Network Planning: Retail chains can utilize isochrones and isodistances to assess the proximity of potential store locations to their target customer base, helping them make informed decisions about expanding their network and optimizing market coverage.
  • Location-based Marketing Campaigns: By leveraging isolines, businesses can identify regions within specific distances and travel time ranges from their physical stores or business locations. This information allows them to effectively target marketing campaigns and personalize offers based on customers' proximity.
  • Real Estate Development: Real estate developers can leverage isolines to analyze the accessibility of properties to amenities such as schools, parks, or shopping centers. This helps in evaluating the attractiveness of locations for potential buyers or renters.
  • Supply Chain Optimization: Isodistances are crucial in optimizing supply chain networks. Businesses can determine regions within the desired time and distance ranges from their warehouses or distribution centers, enabling them to position inventory and improve distribution efficiency strategically.
  • Infrastructure Planning: Urban planners and government agencies can utilize isolines to analyze the accessibility of regions to critical infrastructure such as transportation hubs, healthcare facilities, or educational institutions. This information helps in making informed decisions about infrastructure development and resource allocation.
  • Site Selection for Business Expansion: Companies looking to expand their operations can leverage isolines to evaluate potential locations based on their proximity to key resources, workforce availability, and market reach, aiding in strategic decision-making.
  • Field Service Management: Isodistances can assist businesses in optimizing field service operations by identifying regions that can be efficiently covered within specific travel distances. This enables better resource allocation, reduces travel times, and improves customer satisfaction.
  • Emergency Service Planning: Emergency service providers can use isolines to determine regions that fall within specific response time thresholds. This helps optimize the placement of emergency service facilities and ensure timely assistance during critical situations.

Features and capabilities

The Isoline API offers a wide range of features and capabilities to enhance your location-based applications. Here are the key functionalities of the Isoline API:

Calculating Isolines and Isochrones

Isoline API allows you to generate isolines by time and distance - isochrones and isodistances.

The Isoline API supports ranges of up to 60 minutes for isochrones and up to 60 kilometers for isodistances. This range limitation ensures efficient processing and response times for most applications. However, if you require larger ranges, custom requests are available to accommodate your specific needs.

Contact us to discuss your requirements and explore the possibilities of customizing the Isoline API for your unique use cases.

Different Travel Modes

The Isoline API supports a variety of travel modes to calculate isolines and isochrones. You can choose from modes such as drive, trucks, including modes for different types of trucks, bikes, pedestrian modes for walking and hiking, and more.

Please see the documentation for more information about the travel modes supported.

Avoidance of Unwanted Parts of Road

The Isoline API provides the capability to exclude specific parts of the road network from isolines and isochrones. You can avoid toll roads, ferries, highways, or particular locations based on your requirements, allowing for precise route customization.

Traffic Consideration

Incorporating the approximated traffic model, the Isoline API takes into account traffic conditions while calculating isochrones. This feature allows you to factor in real-world traffic patterns, enhancing the accuracy of travel time calculations.

Choosing Desired Route Type

The Isoline API offers the ability to select the desired route type for isolines and isochrones. You can choose between balanced routes (considering various factors like distance and time), short routes, or routes with fewer manoeuvers. This flexibility allows you to tailor the analysis to specific needs.

Learn more about the parameters and functionalities of the Isoline API on the API documentation page. There, you will find detailed information on how to make API requests, specify travel modes, customize route options, and utilize additional features.

Getting started

The Isoline API works via HTTP GET requests, making it compatible with any programming language that supports HTTP communication. So whether you prefer to use Python, JavaScript, Java, Ruby, or any other language, you can easily integrate and call the Isoline API.

Below, you'll find a step-by-step guide on how to make an Isoline API call:

Step 1. Sign up and obtain an API key

To access the Isoline API, you'll need to sign up for a Geoapify account and obtain an API key.

You can sign up and start using the Isoline API for free without the need to provide credit card information. Geoapify offers a free tier that allows you to explore the capabilities of the Isoline API and integrate it into your applications without any upfront costs.

Step 2. Constructing an Isoline API request

Our comprehensive documentation provides detailed information on the API endpoint, parameters, and response formats. Take some time to explore the documentation to understand how to structure your API requests and interpret the responses.

To assist you in generating Isoline API request URLs more interactively, we provide the Isoline Playground. The Isoline Playground is a user-friendly tool that allows you to experiment with different parameters and options to build your Isoline API request URL.

The following is an example of a URL for an API request:

  • The URL is using the Geoapify Isoline API endpoint "https://api.geoapify.com/v1/isoline" to generate isolines.
  • The latitude and longitude coordinates (lat=40.445149&lon=-3.364434) specify the location from which the isolines will be calculated.
  • The type parameter (type=time) indicates that the isolines represent travel time - isochrone.
  • The mode parameter (mode=drive) defines the travel mode as driving.
  • The range parameter (range=1800) specifies the maximum travel time in seconds (1800 seconds = 30 minutes) for the isolines.
  • The apiKey parameter (apiKey=YOUR_API_KEY) should be replaced with your actual API key obtained from Geoapify.
Step 3. Making API calls

Once you have constructed your API request, you can make HTTP calls to the Isoline API endpoint using your API key. Send the request and await the response from the API server.

Here are examples of calling the Isoline API using different programming languages:

.then(resp => resp.json())
.then((isolineGeoJSON) => {
Step 3. Visualize the isoline GeoJSON on the map

The Isoline API returns a GeoJSON object as the response, which is a popular format for representing geographic data.

Most mapping libraries and frameworks have built-in support for handling and visualizing GeoJSON objects. These libraries offer functions or methods to easily load and display GeoJSON data on a map. Whether you are using Leaflet, Mapbox GL, Google Maps, or other mapping libraries, you will find robust support for working with GeoJSON.


At Geoapify, we utilize a credit-based system for pricing the Isoline API. The cost of using the Isoline API in credits is determined by the isoline range you provide.

One credit is consumed for every 5 minutes of isochrone or 5 kilometers of isodistance.

To meet diverse usage needs, Geoapify provides a range of pricing plans that offer increased credit allocations and additional features. For detailed information about these plans and their corresponding pricing structures, please visit our Pricing page.

Our Free Plan includes 3000 credits per day. This allows you to get started with the Isoline API and experiment with its capabilities at no cost. The free plan provides a generous allowance for small-scale projects or low-volume usage.

Here are a few examples to illustrate how Isoline API costs are calculated:

  • Example 1: Generating a 30-minute isochrone will consume 6 credits (30 minutes / 5 minutes per credit).
  • Example 2: Creating a 50-kilometer isodistance will consume 10 credits (50 kilometers / 5 kilometers per credit).
  • Example 3: Calculating a 90-minute isochrone will require 18 credits (90 minutes / 5 minutes per credit) from your credit balance.


What is the Isoline API?

The Isoline API is a service that allows you to generate isolines, including isochrones (areas reachable within specified travel times) and isodistances (areas reachable within specified distances) for a given location with an HTTP Get request. It enables you to visualize and analyze accessibility in your applications.

What travel modes are supported by the Isoline API?

The Isoline API supports various travel modes, including drive, truck, bike, hike, walk, and transit. You can choose the appropriate travel mode based on your specific use case and requirements.

What is the maximum range for isochrones and isodistances?

The Isoline API accepts ranges up to 60 minutes for isochrones and up to 60 kilometers for isodistances. If you require larger ranges, custom requests are available to accommodate your specific needs.

What format does the Isoline API response return?

The Isoline API response returns GeoJSON, which is a widely used format for representing geographical data. GeoJSON provides a standardized way to describe geographic features and their properties.

What is the pricing model for the Isoline API?

Geoapify offers a flexible pricing model based on credits, where the number of credits consumed depends on the range of the isoline. The exact pricing details, credit allocations, and available plans can be found on our Pricing page.

Is there a free plan available for the Isoline API?

Yes, Geoapify offers a free plan that allows you to start using the Isoline API at no cost. The free plan includes 3000 of credits per day, making it suitable for small-scale projects or initial development stages.

Can I store the isoline object returned by the Isoline API?

Yes, you can store the isoline object returned by the Isoline API for future use. The API response, typically in GeoJSON format, can be saved in your application's database or any storage medium of your choice. Storing isoline objects allows you to reuse them, perform further analysis, or display them on maps without the need to regenerate them every time.

Remember, if you have any specific inquiries or require detailed information, it's always recommended to refer to our documentation, developer guides, or contact our support team directly.

World map

Empower Your Location-Based Applications with Isolines!

Sign Up for Free and Start Building Isolines Today!