Route Optimization API

Key Features

With the Route Optimization API, you can:

• Optimize Routes:
  Retrieve the best route(s) for multiple origins and destinations while considering factors such as traffic conditions, road restrictions, vehicle specifications, and user preferences.

• Comprehensive Route Details:
  Access detailed information, including:

  • Order of Visits: The recommended sequence for your stops.
  • Total Travel Time and Distance: Clear insights into the duration and length of your journey.
  • Estimated Arrival and Departure Times: Get accurate time predictions for your trip.
  • Route Instructions: Step-by-step navigation to ensure a smooth journey.

Use Cases

Usage

curl https://mapapi.gebeta.app/api/route/tss/?json=[]&apiKey={yourapikey}

Parameters

Response Codes for Route Optimization API

Route Optimization API - CURL Request

To get a route using the TSS API, you can use the following curl command:

curl "https://mapapi.gebeta.app/api/route/tss/?json=[{8.989022,38.79036},{9.03045,38.76530}]&apiKey={your-api-key}"

Example

fetch('https://mapapi.gebeta.app/api/route/tss/?json=[{8.989022,38.79036},{9.03045,38.76530}]&apiKey={your-api-key}')
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

API Limits and Restrictions

The Route Optimization API has some restrictions and limits that you need to be aware of before using it:

• Coordinates Waypoints: Should only be less than or equal to 10.
• Rate Limit: 50 requests per second from a single API token. If you exceed this limit, you will receive an error message and your requests will be rejected. To avoid this, you can throttle your requests or use multiple tokens for different applications or users.
• Inter-Country Requests: Not allowed. You can only request directions within the same country or region. If you try to request directions across different countries or regions, you will receive an error message, and your request will be invalid. For inter-country travel, consider using other map services or APIs that support this feature.

Pricing

The Route Optimization API charges you based on the number of elements you request. An element is the travel time and distance between one origin and one destination. The price per element decreases as you request more elements:

For example, if you request 20,000,000 elements, you will pay $20,000. Note that one Route Optimization API call is considered by the number of coordinates in the json array, so you will be charged accordingly. For more information, check the pricing page.