OpenRouteService API

maps openrouteservice

OpenRouteService API

Routing, isochrones, and matrix directions based on OpenStreetMap.

Quick Facts

FieldValue
ProviderOpenRouteService
CategoryMaps & Location APIs
Websitehttps://openrouteservice.org
AuthenticationAPI Key
Pricing Modelfreemium
Free TierYes, generous free tier
Rate Limit100 req/min (free tier)

Overview

OpenRouteService API is a maps & location apis provided by OpenRouteService. Routing, isochrones, and matrix directions based on OpenStreetMap. This API is designed to help developers integrate maps capabilities into their applications with minimal setup and maximum reliability.

The API supports API Key authentication, ensuring secure access to all endpoints. With a freemium pricing model, OpenRouteService offers flexible options for projects of any size, from prototypes to enterprise deployments.

OpenRouteService maintains comprehensive documentation, SDKs for popular programming languages, and active community support. The API is built on REST principles, returning JSON responses with standard HTTP status codes, making it straightforward to integrate into existing workflows.

Authentication

This API uses API Key authentication. Send your API key in the request header or as a query parameter. The exact method depends on the API specification.

Always store your credentials securely using environment variables or a secrets manager. Never commit API keys to version control or expose them in client-side code.

Code Samples

Python

import requests
import os

API_KEY = os.environ.get("API_KEY", "YOUR_API_KEY")
BASE_URL = "https://api.openrouteservice.org"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

response = requests.get(f"{BASE_URL}/v1/resources", headers=headers)
print(response.status_code)
print(response.json())

JavaScript

const API_KEY = process.env.API_KEY || 'YOUR_API_KEY';
const BASE_URL = 'https://api.openrouteservice.org';

const response = await fetch(`${BASE_URL}/v1/resources`, {
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  }
});
const data = await response.json();
console.log(data);

cURL

curl -H "Authorization: Bearer $API_KEY" \
     -H "Content-Type: application/json" \
     https://api.openrouteservice.org/v1/resources

Go

package main

import (
    "net/http"
    "fmt"
    "io"
    "os"
)

func main() {
    apiKey := os.Getenv("API_KEY")
    if apiKey == "" {
        apiKey = "YOUR_API_KEY"
    }
    req, _ := http.NewRequest("GET", "https://api.openrouteservice.org/v1/resources", nil)
    req.Header.Set("Authorization", "Bearer " + apiKey)
    req.Header.Set("Content-Type", "application/json")
    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Pricing

The pricing model is freemium. Free tier with generous limits, paid plans for higher usage and premium features. Visit the provider’s pricing page at https://openrouteservice.org for current rates and detailed pricing information.

Use Cases

  • Integration: Connect OpenRouteService services to your application for seamless maps functionality.
  • Automation: Automate maps workflows and reduce manual operations.
  • Scaling: Handle growing maps demands with OpenRouteService’s robust infrastructure.

Further Reading

Other languages