Matrix API

Harness the power of the Matrix API to efficiently calculate optimal routes tailored to various scenarios. Whether you're looking to streamline delivery routes, plan seamless trips, or analyze traffic patterns, this API offers valuable insights to enhance your decision-making. With its ability to handle multiple origins and destinations simultaneously, the Matrix API is an essential tool for logistics, travel planning, and urban mobility analysis.

Use Cases

Usage

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

Parameters

Response Codes for Matrix API

Matrix API - CURL Request

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

curl "https://mapapi.gebeta.app/api/route/matrix/?json=[{latitude1,longitude1},{latitude2,longitude2}]&apiKey={your-api-key}"

Example

fetch('https://mapapi.gebeta.app/api/route/matrix/?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 Matrix 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 Matrix 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 Matrix 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.