Gebeta Maps

ONM API

A comprehensive service that provides travel times and distances between multiple origins and destinations.

Use the ONM API to calculate the best routes for different scenarios, such as optimizing delivery routes, planning trips, or analyzing traffic patterns.

Use Cases

🏪

Nearest Point of Interest

Locate the nearest points of interest from your current location, such as restaurants, hospitals, or gas stations.

📦

Delivery Route Optimization

Optimize your delivery routes by finding the best order to visit multiple destinations.

🗺️

Trip Planning

Plan your trips effectively by identifying the best routes to multiple destinations.

💰

Transportation Cost Estimation

Estimate transportation costs by calculating travel distances, fuel prices, and vehicle efficiency.

📊

Traffic Data Access

Utilize real-time and historical traffic data for research, planning, or forecasting purposes.

Usage

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

Parameters

ParameterTypeDescriptionRequired
originstringThe origin in latitude and longitude format, e.g., {longitude, latitude}.yes
jsonstring[]An array of semicolon-separated latitude and longitude pairs to specify which places to visit along the way.yes
apiKeystringYour API key for accessing Gebeta Maps.yes

Response Codes for ONM API

Status CodeMessageDescription
200OKThe request was successful. The system found a valid route and returned the requested data.
404NoRouteNo route exists between the specified locations. Confirm that the locations are accessible by route.
401Not Authorized - No TokenAuthentication failed. No valid token was provided. Please include a valid authentication token.
401Not Authorized - Invalid TokenThe authentication token provided is either invalid or expired. Use a current, valid token.
422InvalidInputThe request parameters are incorrect. Review the input values and adjust as needed.

ONM API - CURL Request

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

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

Example

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

API Limits and Restrictions

The ONM 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 ONM 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:

Request VolumeCost per 10,000 Elements
First 1,000,000 elements$2
Next 4,000,000 elements$1.75
Next 5,000,000 elements$1.5
Over 10,000,000 elements$1

For example, if you request 20,000,000 elements, you will pay $20,000. Note that one ONM 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.

Previous

Matrix API

Next

Route Optimization API

On this page