osrmroute
API Belgeleri, SDK’lar ve Entegrasyon KılavuzlarıEntegrasyon ve geçiş
OSRMRoute / API

API Belgeleri, SDK’lar ve Entegrasyon Kılavuzları

API uç noktalarını, kimlik doğrulamayı, limitleri ve örnekleri inceleyin. Mobil SDK, CLI, MCP, harita stilleri, yer arama ve yol verilerini entegre edin.

OpenAPI · Postman

API kataloğu

API’yi adına, kullanım amacına veya uç noktasına göre bulun. Her bağlantı parametrelere, örneklere ve kullanım sınırlarına yönlendirir.

Navigasyon (10)
  • Routing API →

    Sürüş, bisiklet veya yürüyüş için verilen noktalardan sırayla geçen rotayı hesaplayın. Dönüş talimatları için steps=true, GeoJSON için geometries=geojson kullanın.

    GET /api/v1/osrm/route/v1/{profile}/{coordinates}
  • Isochrones API →

    Örnek noktalara yolculuk sürelerinden erişilebilirliği tahmin eder. Her yönde ulaşılabilir bir nokta varsa quality.status estimated olur; aksi halde insufficient_data ve boş polygons döner. Boş sonuç, ulaşılabilir yol olmadığını kanıtlamaz. Sınır yaklaşık hesaplanır; yalnızca süre sınırı desteklenir.

    GET /api/1/isochrone
  • Map Matching API →

    Hatalı GPS izlerini gerçek yol ağına hizalar (snap to road). GPS sinyallerindeki gürültüyü temizlemek için kullanılır.

    GET /api/v1/osrm/match/v1/{profile}/{coordinates}
  • Nearest API →

    Herhangi bir koordinatı en yakın gerçek yol segmentine hizalar (snap) ve yol adı hakkında bilgi döndürür.

    GET /api/v1/osrm/nearest/v1/{profile}/{coordinates}
  • Directions API →

    İki veya daha fazla nokta arasında adım adım navigasyon döndürür — temiz bir talimat listesiyle (metin, mesafe, süre, manevra türü ve konum). Araç, bisiklet ve yayanın yanı sıra tek çağrıda 3’e kadar alternatif rota destekler.

    GET /api/1/directions
  • Alternative Routes API →

    İki veya daha fazla nokta arasında adım adım navigasyon döndürür — temiz bir talimat listesiyle (metin, mesafe, süre, manevra türü ve konum). Araç, bisiklet ve yayanın yanı sıra tek çağrıda 3’e kadar alternatif rota destekler.

    GET /api/1/directions
  • Snap to Road API →

    Ham, hatalı GPS noktalarını yol ağındaki en yakın konuma yapıştırır. Her koordinat için point parametresini tekrarlayın (en fazla 100).

    GET /api/1/snap
  • Yakıt Tahmin API →

    Mesafe, yüklü ağırlık, boş/tam yüklü tüketim ve litre fiyatıyla yakıt miktarını ve yolculuk değerini tahmin edin. Ayrı veya Truck içinde kullanın.

    POST /api/v1/fuel/estimate
  • Truck Routing API →

    Bağlantılı yollarda ülke içi ve sınır ötesi kamyon rotaları planlayın. Her istekte aracın boyutlarını ve yüklü ağırlığını gönderin.

    POST /api/v1/truck/route
  • Search Along Route API →

    Yol üzerindeki durakları ve ek sürüş süresini karşılaştırın.

    POST /api/v1/places/along-route
Operasyon ve yük planlaması (7)
  • Route Optimization API →

    Kapasite, zaman aralıkları, yetkinlikler ve bağlantılı alım/teslimat kısıtlarıyla filo rotalarını planlar. Süresi sınırlı sezgisel algoritma yolculuk süresini azaltır; küresel optimum garantisi vermez. Atanamayan görevler solution.unassigned içinde kalır; geçersiz girdinin tamamı reddedilir.

    POST /api/1/vrp
  • Matrix API →

    Başlangıç ve varış noktaları arasındaki süreyi, mesafeyi veya her ikisini hesaplayın. Koordinat listesindeki indisleri sources ve destinations ile seçin.

    GET /api/v1/osrm/table/v1/{profile}/{coordinates}
  • Trip API (TSP) →

    Yol ağına göre tek bir aracın duraklarını sıralayın. Açık rota için roundtrip=false&source=first&destination=last gönderin. Sıralamanın en iyi sonucu vereceği garanti edilmez.

    GET /api/v1/osrm/trip/v1/{profile}/{coordinates}
  • Konum Kümeleme →

    Verilen koordinatları coğrafi yakınlıklarına ve yoğunluklarına göre gruplar (kümelere ayırır).

    POST /api/1/cluster
  • Yük planlama →

    Karışık yükleri kamyon, treyler ve konteyner için planlayın. İstiflemeyi, yükleme sırasını ve alanı 3D inceleyin veya API’yi kendi yazılımınıza bağlayın.

    POST /api/v1/load-plansGET /api/v1/load-plansGET /api/v1/load-plans/{id}
    Tüm endpointler (+38)
    DELETE /api/v1/load-plans/{id}POST /api/v1/load-plans/{id}/cancelGET /api/v1/load-plans/{id}/worksheetGET /api/v1/load-plans/{id}/csvGET /api/v1/load-plans/{id}/modelGET /api/v1/load-plans/pricesGET /api/v1/load-plans/import-previewPOST /api/v1/load-plans/import-previewPOST /api/v1/load-plans/comparePOST /api/v1/load-plans/fleetPOST /api/v1/load-plans/{id}/placement-previewPOST /api/v1/load-plans/{id}/placement-revisionsGET /api/v1/load-plans/{id}/pdfGET /api/v1/load-plans/{id}/xlsxPOST /api/v1/load-plans/{id}/shareDELETE /api/v1/load-plans/{id}/sharePOST /api/v1/load-plans/shared-viewPOST /api/v1/load-plans/palletizePOST /api/v1/load-plans/{id}/axle-estimateGET /api/v1/load-plans/workspace/{kind}GET /api/v1/load-plans/workspace/{kind}/{id}PUT /api/v1/load-plans/workspace/{kind}/{id}DELETE /api/v1/load-plans/workspace/{kind}/{id}GET /api/v1/load-plans/webhookPOST /api/v1/load-plans/webhookDELETE /api/v1/load-plans/webhookGET /api/v1/load-plans/webhook/eventsPOST /api/v1/load-plans/webhook/events/{id}POST /api/v1/load-plans/multi-stopPOST /api/v1/load-plans/bulkPOST /api/v1/load-plans/packagingPOST /api/v1/load-plans/dispatchPOST /api/v1/load-plans/fulfillmentPOST /api/v1/load-plans/simulationGET /api/v1/load-plans/{id}/warehousePOST /api/v1/load-plans/{id}/warehouseGET /api/v1/load-plans/{id}/simulation-reportGET /api/v1/load-plans/partner
  • Yolculuk analitiği: ziyaret kanıtı →

    Gönderilen izden ziyaret ve bekleme kanıtı.

    POST /api/v1/trip-analytics/visit-proof
  • Kamyon filosu optimizasyonu →

    Araca özgü statik kamyon matrisleri.

    POST /api/v1/truck/optimize
Arama (8)
  • Geocoding API →

    Bir arama metnini coğrafi koordinatlara (ileri) veya koordinatları bir adrese (ters) dönüştürür. Sokakları, adresleri ve ilgi noktalarını (kafe, mağaza, otel, ofis) kapsayan hızlı, yazım hatasına toleranslı otomatik tamamlama. Yazarken arama için idealdir.

    GET /api/1/geocode
  • Places API →

    Bir konumun yakınındaki ilgi noktalarını bul — kafeler, mağazalar, oteller, ATMler, eczaneler ve daha fazlası — kategori ve yarıçapa göre süzülmüş, mesafeye göre sıralı.

    GET /api/1/places
  • Autocomplete API →

    Kullanıcı yazarken hızlı, yazım hatasına toleranslı yer önerileri (konum ağırlığı ile).

    GET /api/1/autocomplete
  • Batch Geocoding API →

    Tek istekte en fazla 100 adresi coğrafi kodlayın. Sonuçlar giriş sırasıyla döner ve her adres sorgusu bir krediye mal olur.

    POST /api/1/geocode/batch
  • Doğal dil araması →

    Kısa İngilizce sorgularla yerleri bulun.

    POST /api/v1/search/natural
  • Yer ayrıntıları →

    Arama kaynağındaki yer bilgilerini okuyun.

    POST /api/v1/places/details
  • Structured Geocoding API →

    Sokak, şehir, posta kodu ve ülkeyle adres arayın.

    POST /api/v1/search/structured
  • Suggest & Retrieve API →

    Öneriler ve güvenli sonuç alma ile yer araması geliştirin.

    POST /api/v1/search/suggestPOST /api/v1/search/retrieve
Haritalar (4)
  • Metinle stil önizlemesi →

    Renk ve katman değişikliklerini yazıp inceleyin.

    POST /api/v1/studio/preview
  • Static Maps API →

    Raporlar ve uygulamalar için stilli haritaları PNG olarak dışa aktarın.

    POST /api/v1/maps/static
  • Studio API →

    Uygulamanızdan harita stillerini, veri kümelerini ve yayınlamayı yönetin.

    GET /api/v1/studio/{resource}POST /api/v1/studio/{resource}
  • Harita stilleri ve vektör döşemeleri →

    Herkese açık temel haritaları veya yayımlanan stilleri MapLibre ile yükleyin. Açık istekler anahtar gerektirmez ve kredi harcamaz. Stil içindeki döşeme adreslerini kullanın ve kaynak atfını koruyun.

    GET /api/basemaps/{style}GET /api/map-styles/{id}GET /api/map-styles/{id}/tiles/{dataset}/{z}/{x}/{y}
    Tüm endpointler (+2)
    GET /api/private-maps/{id}GET /api/private-maps/{id}/tiles/{dataset}/{z}/{x}/{y}
Veri (15)
  • Timezone API →

    Dünyadaki herhangi bir koordinat için IANA saat dilimi, güncel UTC farkı, DST durumu ve yerel saat.

    GET /api/1/timezone
  • Elevation API →

    Herhangi bir koordinat için deniz seviyesinden yükseklik (metre) — tek nokta ya da tüm rota profili.

    GET /api/1/elevation
  • Boundary Lookup API →

    Bir koordinatın hangi ülke, eyalet, şehir ve ilçeye düştüğünü bulun — istenirse sınır poligonuyla.

    GET /api/1/boundary
  • Geofencing API →

    Tek çağrıda her noktanın hangi bölgelerinize düştüğünü test edin — poligon veya dairesel çitler.

    POST /api/1/geofence
  • Elevation Profile API →

    Yolun her noktasında yükseklik + toplam tırmanma, iniş ve mesafe — tam rota profili.

    POST /api/1/elevation/profile
  • Solar API →

    Herhangi bir koordinat ve tarih için gün doğumu, gün batımı, alacakaranlık, öğle ve gün uzunluğu.

    GET /api/1/solar
  • Geometry Utilities API →

    Mesafe, kerteriz, alan, merkez, sadeleştirme ve polyline encode/decode — mekânsal matematik servis olarak.

    POST /api/1/geometry
  • Coordinate Conversion API →

    Enlem/boylamı UTM ve MGRS ızgara referanslarına ve tersine dönüştür.

    GET /api/1/convert
  • Country Info API →

    Herhangi bir ülke için para birimi, arama kodu, diller, başkent ve bayrak — ISO kodu veya adıyla.

    GET /api/1/country
  • Dataset Query API →

    Kendi yüklediğiniz coğrafi verilerde yakın öğeleri bulun.

    POST /api/v1/maps/datasets/{id}/query
  • Yol Verileri API →

    Mevcut kapsamda hız sınırları, yol özellikleri ve trafik işareti gözlemleri.

    POST /api/v1/roads/lookupPOST /api/v1/roads/batch
  • Hesap kullanımı →

    Yol verileri: ayda 100.000 işlem

    POST /api/v1/roads/usage
  • Yol İşaretleri API →

    Seçilen harita alanındaki yol işareti gözlemlerini bulun. İşaret sınıfları, koordinatlar, yönler ve gözlem tarihlerini imleçli sayfalama ile alın.

    POST /api/v1/roads/signs
  • Rota uygunluk kanıtı →

    Gönderilen rota konumları için kaynak nitelikli hız kanıtı.

    POST /api/v1/roads/compliance
  • Yol hız sınırı sorgusu →

    Koordinata yakın yolun haritalanmış otomobil hız sınırını alın. Sınır eksik veya belirsizse sonuç null olur.

    GET /api/1/speed-limit
Platform Entegrasyon Kılavuzu (6)
  • Asenkron görevler →

    İşlemler: geocode_batch, matrix, optimize. POST /api/jobs, 202 ve görev kimliği döndürür. Aynı Idempotency-Key ve içerik mevcut görevi döndürür; farklı içerik 409 döndürür.

    POST /api/jobsGET /api/jobsGET /api/jobs/{id}
    Tüm endpointler (+1)
    DELETE /api/jobs/{id}
  • Sandbox API →

    Ücretli canlı isteğe geçmeden önce örnek verili sandbox ortamında yanıt ayrıştırmasını doğrulayın.

    POST /api/sandbox
  • Kaynak meta verileri →

    Hizmete göre veri kaynaklarını, coğrafi kapsamı ve güncelliği inceleyin.

    GET /api/source-metadata
  • Mobil erişim →

    Mobil uygulamanızı gizli API anahtarı eklemeden bağlayın.

    POST /api/mobile/challengePOST /api/mobile/token
  • Uzak MCP API →

    AI araçlarını konum hizmetlerine bağlayın.

    POST /api/mcp
  • Uyumluluk uç noktaları →

    Mevcut entegrasyonu ana API’ye taşımadan önce koordinat sırasını ve yanıt birimlerini kontrol edin.

    GET /api/v1/route/{profile}/{coordinates}GET /api/1/routeGET /api/1/route/info
    Tüm endpointler (+9)
    GET /api/1/matrixPOST /api/1/matrixPOST /api/1/matrix/calculatePOST /api/1/matchPOST /api/1/elevationPOST /api/1/optimizePOST /api/1/vrp/optimizePOST /api/1/cluster/calculatePOST /api/1/batch-geocode

Giriş

#

OSRMRoute yol rotaları, filo planlama, adres arama, haritalar ve coğrafi veriler için API’ler sunar. Entegre edeceğiniz işlemin kılavuzunu katalogda bulun.

Güncel plan limitleri

Kredi ve dakikalık istek limitleri hesabın tüm anahtarları arasında paylaşılır. Anahtarın ek kredi sınırı hesap bütçesini artırmaz. Önce paket, sonra satın alınan krediler kullanılır.

Free planına limitler dahilinde Routing, Route Optimization, Geocoding (ters adres arama ve otomatik tamamlama dahil) ve Matrix API’leri dahildir. Map Matching, Isochrone, Truck Routing, Fuel Estimate ve diğer ayrı API’ler için PAYG dahil ücretli plan gerekir. API erişimi hesabın geçerli planına bağlıdır; pozitif bakiye tek başına Free kısıtlamalarını kaldırmaz. Yol verileri ve AI için ayrı Business gereklilikleri geçerlidir.

Route, Directions ve Truck Routing: işlenen istekte yakında erişilebilir yol veya bağlantılı rota bulunamazsa PAYG dahil uygun tüm planlarda bir kez 0,5 kredi alınır. Geçersiz girdi, erişim/plan veya desteklenmeyen yol ağı kapsamı nedeniyle ret ve sunucu hataları ücretsizdir. Önce başarılı isteğin bedeli rezerve edilir; kullanılmayan kısım iade edilir.

Limitler yükleniyor…

Herkese açık harita demosu ayrı demo limitleriyle Route, Matrix, Match, Nearest ve Trip hizmetlerini destekler. Diğer hizmetler için API anahtarınızı ve aşağıdaki örnekleri kullanın.

Kimlik Doğrulama

#

API anahtarını Authorization başlığında Bearer belirteci olarak gönderin. Gerekli anahtar kapsamını ve ortamı işlem kılavuzundan kontrol edin. Bazı eski uç noktalar URL parametresinde anahtar kabul eder.

HTTP
Authorization: Bearer YOUR_API_KEY

Hata Kodları

#

OSRMRoute, bir isteğin durumunu belirtmek için standart HTTP durum kodları ve ayrıntılı JSON hata mesajları kullanır.

Hatalar error ve isteğe bağlı code içerebilir. Yalnızca mesaj metnine güvenmeyin; HTTP durumunu ve kalan limit başlıklarını okuyun. Reset başlıkları gece yarısını değil kayan zaman aralığını belirtir.

X-RateLimit-Limit · X-RateLimit-Remaining · X-RateLimit-Reset · X-Compute-* · X-Quota-* · X-Credits-* · Retry-After

Geçerli API anahtarı girin ve panelde durumunu kontrol edin.

HTTP 401
{
  "error": "Invalid API Key"
}

Bakiye yükleyin veya uygun bir plan seçin.

HTTP 402
{
  "error": "Insufficient balance: this request costs 1 credit and your balance is 0 credits. Top up your account to continue."
}

Planın karmaşıklık limitlerini ve anahtar kısıtlarını kontrol edin.

HTTP 403
{
  "error": "This API Key is disabled"
}

Varsa Retry-After değerine uyun ve istek sıklığını azaltın.

HTTP 429
{
  "error": "Rate limit exceeded: this account has exceeded its configured requests-per-minute limit. Please slow down."
}

Hizmet veya veri kaynağı kullanılamıyor. Bekleme süresini artırarak dikkatle yeniden deneyin.

HTTP 500
{
  "error": "Internal Server Error"
}

Routing API

#

Sürüş, bisiklet veya yürüyüş için verilen noktalardan sırayla geçen rotayı hesaplayın. Dönüş talimatları için steps=true, GeoJSON için geometries=geojson kullanın.

GET
/api/v1/osrm/route/v1/{profile}/{coordinates}

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
profilestringZorunludrivingUlaşım türü profili. Desteklenen değerler: driving (otomobil), cycling (bisiklet), walking (yaya).
coordinatesstringZorunlu-Noktaların koordinatları. Biçim: lon,lat;lon,lat;lon,lat... (en az 2 nokta).
overviewstringİsteğe bağlısimplifiedDöndürülen rota geometrisinin ayrıntı düzeyi: simplified (sadeleştirilmiş), full (tam geometri), false (geometrisiz).
geometriesstringİsteğe bağlıpolylineGeometri biçimi: geojson (GeoJSON nesnesi), polyline (kodlanmış dize).
stepsbooleanİsteğe bağlıfalseHer dönüş için adım adım talimatların döndürülüp döndürülmeyeceği.
alternativesinteger | booleanİsteğe bağlıfalseAranacak alternatif rota sayısı. Sonuç yol ağına bağlıdır.

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Routing API
curl "https://osrmroute.com/api/v1/osrm/route/v1/driving/49.8516,40.3777;49.86,40.40?steps=true&overview=full&geometries=geojson" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: Her 10 giriş noktası için 1 kredi, yukarı yuvarlanır; başlangıç ve varış dahildir.

Route, Directions ve Truck Routing: işlenen istekte yakında erişilebilir yol veya bağlantılı rota bulunamazsa PAYG dahil uygun tüm planlarda bir kez 0,5 kredi alınır. Geçersiz girdi, erişim/plan veya desteklenmeyen yol ağı kapsamı nedeniyle ret ve sunucu hataları ücretsizdir. Önce başarılı isteğin bedeli rezerve edilir; kullanılmayan kısım iade edilir.

OSRM yolu: lon,lat; GeoJSON: [lon,lat].

  • points ≥ 2; points ≤ plan.maxRoutePoints
  • snap_distance_m ≤ 2000

Sürüş, yürüyüş ve bisiklet küreseldir. Noktalar seçilen ulaşım türüne uygun yollarla bağlanmalıdır. VRP sezgiseldir, izokronlar yaklaşıktır; küresel optimum veya canlı trafik vaat edilmez.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "code": "Ok",
  "routes": [
    {
      "distance": 3200,
      "duration": 420,
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            49.8516,
            40.3777
          ],
          [
            49.86,
            40.4
          ]
        ]
      },
      "legs": [
        {
          "distance": 3200,
          "duration": 420,
          "steps": []
        }
      ]
    }
  ],
  "waypoints": [
    {
      "name": "Example road",
      "location": [
        49.8516,
        40.3777
      ],
      "distance": 4.2
    }
  ]
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "code": "InvalidQuery",
  "error": "Coordinates must be finite longitude,latitude pairs."
}

Desteklenen profili seçin. Araç profiline otomatik geçiş yapılmaz.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

API, seçili profil için tüm noktaları aynı yol ağında işleyemedi. Bağlantılı etapları ayrı isteklerle gönderin.

HTTP 422
{
  "code": "CrossRegionNotSupported",
  "error": "These coordinates are not served by one routing graph. Split the request by region."
}

Noktaların erişilebilir yollara yakın ve bu yolların seçili profil için bağlantılı olduğunu kontrol edin.

HTTP 422
{
  "code": "NoNearbyRoad",
  "error": "No connected route within 2000 metres of the requested coordinates."
}

Hizmet veya veri kaynağı kullanılamıyor. Bekleme süresini artırarak dikkatle yeniden deneyin.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Yanıt Yapısının Açıklaması

Mesafe metre, süre saniye cinsindendir. Varsayılan rota çizgisi basitleştirilmiş, biçimi ise polyline’dır. Tam çizgi için overview=full kullanın.

Matrix API

#

Başlangıç ve varış noktaları arasındaki süreyi, mesafeyi veya her ikisini hesaplayın. Koordinat listesindeki indisleri sources ve destinations ile seçin.

GET
/api/v1/osrm/table/v1/{profile}/{coordinates}

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
profilestringZorunludrivingUlaşım profili (driving, cycling, walking).
coordinatesstringZorunlu-Matris noktaları. Biçim: lon,lat;lon,lat;lon,lat...
annotationsstringİsteğe bağlıdurationHesaplanacak veri: duration (süre), distance (mesafe) veya her ikisi.
sourcesstringİsteğe bağlıallNoktalı virgülle ayrılmış sıfır tabanlı çıkış indisleri veya all.
destinationsstringİsteğe bağlıallNoktalı virgülle ayrılmış sıfır tabanlı varış indisleri veya all.

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Matrix API
curl "https://osrmroute.com/api/v1/osrm/table/v1/driving/49.85,40.37;49.86,40.40;49.83,40.39?annotations=duration,distance" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: max(1, ceil(cells * 2 / 5))

OSRM yolu: lon,lat; GeoJSON: [lon,lat].

  • points ≥ 2; points ≤ plan.maxRoutePoints
  • cells = sources × destinations
  • credits = max(1, ceil(cells * 2 / 5))

Sürüş, yürüyüş ve bisiklet küreseldir. Noktalar seçilen ulaşım türüne uygun yollarla bağlanmalıdır. VRP sezgiseldir, izokronlar yaklaşıktır; küresel optimum veya canlı trafik vaat edilmez.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "code": "Ok",
  "durations": [
    [
      0,
      420
    ],
    [
      430,
      0
    ]
  ],
  "distances": [
    [
      0,
      3200
    ],
    [
      3300,
      0
    ]
  ],
  "sources": [
    {
      "name": "Example road",
      "location": [
        49.8516,
        40.3777
      ],
      "distance": 4.2
    },
    {
      "name": "Second road",
      "location": [
        49.86,
        40.4
      ],
      "distance": 3
    }
  ],
  "destinations": [
    {
      "name": "Example road",
      "location": [
        49.8516,
        40.3777
      ],
      "distance": 4.2
    },
    {
      "name": "Second road",
      "location": [
        49.86,
        40.4
      ],
      "distance": 3
    }
  ]
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "code": "InvalidQuery",
  "error": "Coordinates must be finite longitude,latitude pairs."
}

Desteklenen profili seçin. Araç profiline otomatik geçiş yapılmaz.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

API, seçili profil için tüm noktaları aynı yol ağında işleyemedi. Bağlantılı etapları ayrı isteklerle gönderin.

HTTP 422
{
  "code": "CrossRegionNotSupported",
  "error": "These coordinates are not served by one routing graph. Split the request by region."
}

Noktaların erişilebilir yollara yakın ve bu yolların seçili profil için bağlantılı olduğunu kontrol edin.

HTTP 422
{
  "code": "UnreachablePoints",
  "error": "Some locations are disconnected in this road network."
}

Hizmet veya veri kaynağı kullanılamıyor. Bekleme süresini artırarak dikkatle yeniden deneyin.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Yanıt Yapısının Açıklaması

Varsayılan olarak durations matrisi döner. Mesafeler için annotations=distance, iki matris için annotations=duration,distance kullanın. Süreler saniye, mesafeler metre cinsindendir. Uygun grafiklerin hiçbiri matrisi tamamlayamazsa bağlantısız noktalar için HTTP 422 UnreachablePoints döner.

Map Matching API

#

Hatalı GPS izlerini gerçek yol ağına hizalar (snap to road). GPS sinyallerindeki gürültüyü temizlemek için kullanılır.

GET
/api/v1/osrm/match/v1/{profile}/{coordinates}

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
geometriesstringİsteğe bağlıpolylineGeometri biçimi: geojson (GeoJSON nesnesi), polyline (kodlanmış dize).
profilestringZorunludrivingUlaşım profili.
coordinatesstringZorunlu-Hizalanacak GPS koordinatları dizisi (lon,lat;lon,lat...)
overviewstringİsteğe bağlısimplifiedHizalanan rotanın geometri hassasiyeti.
timestampsstringİsteğe bağlı-Her nokta için saniye cinsinden bir Unix zaman damgası. Değerler azalmamalı ve noktalı virgülle ayrılmalıdır.
radiusesstringİsteğe bağlı-Her nokta için metre cinsinden GPS doğruluğu. Değerleri noktalı virgülle ayırın.

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Map Matching API
curl "https://osrmroute.com/api/v1/osrm/match/v1/driving/49.851536,40.375480;49.844011,40.379982;49.839336,40.389620;49.837774,40.389268?overview=full&geometries=geojson" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: 1 credit

OSRM yolu: lon,lat; GeoJSON: [lon,lat].

  • points ≥ 2; points ≤ plan.maxRoutePoints
  • tracepoints[]: object | null

Sürüş, yürüyüş ve bisiklet küreseldir. Noktalar seçilen ulaşım türüne uygun yollarla bağlanmalıdır. VRP sezgiseldir, izokronlar yaklaşıktır; küresel optimum veya canlı trafik vaat edilmez.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "code": "Ok",
  "matchings": [
    {
      "distance": 3200,
      "duration": 420,
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            49.8516,
            40.3777
          ],
          [
            49.86,
            40.4
          ]
        ]
      },
      "legs": [
        {
          "distance": 3200,
          "duration": 420,
          "steps": []
        }
      ],
      "confidence": 0.97
    }
  ],
  "tracepoints": [
    {
      "name": "Example road",
      "location": [
        49.8516,
        40.3777
      ],
      "distance": 4.2
    },
    null
  ]
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "code": "InvalidQuery",
  "error": "Coordinates must be finite longitude,latitude pairs."
}

Desteklenen profili seçin. Araç profiline otomatik geçiş yapılmaz.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

API, seçili profil için tüm noktaları aynı yol ağında işleyemedi. Bağlantılı etapları ayrı isteklerle gönderin.

HTTP 422
{
  "code": "CrossRegionNotSupported",
  "error": "These coordinates are not served by one routing graph. Split the request by region."
}

Noktaların erişilebilir yollara yakın ve bu yolların seçili profil için bağlantılı olduğunu kontrol edin.

HTTP 422
{
  "code": "NoNearbyRoad",
  "error": "No connected route within 2000 metres of the requested coordinates."
}

Hizmet veya veri kaynağı kullanılamıyor. Bekleme süresini artırarak dikkatle yeniden deneyin.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Yanıt Yapısının Açıklaması

matchings[]: distance — mesafe (m), duration — süre (s), confidence — güven (0–1), geometry — geometri; tracepoints[] — nesne veya null.

Nearest API

#

Herhangi bir koordinatı en yakın gerçek yol segmentine hizalar (snap) ve yol adı hakkında bilgi döndürür.

GET
/api/v1/osrm/nearest/v1/{profile}/{coordinates}

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
profilestringZorunludrivingUlaşım profili.
coordinatesstringZorunlu-Yakınında arama yapılacak nokta. Biçim: lon,lat (tek çift).
numberintegerİsteğe bağlı1Bulunacak en yakın yol adaylarının sayısı.

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Nearest API
curl "https://osrmroute.com/api/v1/osrm/nearest/v1/driving/49.8516,40.3777?number=3" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: 1 credit

OSRM yolu: lon,lat; GeoJSON: [lon,lat].

  • coordinates: 1
  • number: default = 1; example = 3

Sürüş, yürüyüş ve bisiklet küreseldir. Noktalar seçilen ulaşım türüne uygun yollarla bağlanmalıdır. VRP sezgiseldir, izokronlar yaklaşıktır; küresel optimum veya canlı trafik vaat edilmez.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "code": "Ok",
  "waypoints": [
    {
      "name": "Example road",
      "location": [
        49.8516,
        40.3777
      ],
      "distance": 4.2
    }
  ]
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "code": "InvalidQuery",
  "error": "Coordinates must be finite longitude,latitude pairs."
}

Desteklenen profili seçin. Araç profiline otomatik geçiş yapılmaz.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

Noktaların erişilebilir yollara yakın ve bu yolların seçili profil için bağlantılı olduğunu kontrol edin.

HTTP 422
{
  "code": "NoNearbyRoad",
  "error": "No connected route within 2000 metres of the requested coordinates."
}

Hizmet veya veri kaynağı kullanılamıyor. Bekleme süresini artırarak dikkatle yeniden deneyin.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Yanıt Yapısının Açıklaması

waypoints[] → name, distance (m), location [lon,lat].

Trip API

#

Yol ağına göre tek bir aracın duraklarını sıralayın. Açık rota için roundtrip=false&source=first&destination=last gönderin. Sıralamanın en iyi sonucu vereceği garanti edilmez.

GET
/api/v1/osrm/trip/v1/{profile}/{coordinates}

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
geometriesstringİsteğe bağlıpolylineGeometri biçimi: geojson (GeoJSON nesnesi), polyline (kodlanmış dize).
profilestringZorunludrivingUlaşım profili.
coordinatesstringZorunlu-Ziyaret edilecek noktalar. Biçim: lon,lat;lon,lat...
sourcestringİsteğe bağlıanyRotanın başlayabileceği nokta (any veya ilk nokta).
destinationstringİsteğe bağlıanyRotanın biteceği nokta (any veya son nokta).
roundtripbooleanİsteğe bağlıtrueBaşlangıca dön. false için source=first ve destination=last kullanın.

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Trip API (TSP)
curl "https://osrmroute.com/api/v1/osrm/trip/v1/driving/49.85,40.37;49.86,40.40;49.83,40.39?source=first&geometries=geojson" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: 5 credits

OSRM yolu: lon,lat; GeoJSON: [lon,lat].

  • points ≥ 2; points ≤ plan.maxRoutePoints
  • credits = 5

Sürüş, yürüyüş ve bisiklet küreseldir. Noktalar seçilen ulaşım türüne uygun yollarla bağlanmalıdır. VRP sezgiseldir, izokronlar yaklaşıktır; küresel optimum veya canlı trafik vaat edilmez.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "code": "Ok",
  "trips": [
    {
      "distance": 3200,
      "duration": 420,
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            49.8516,
            40.3777
          ],
          [
            49.86,
            40.4
          ]
        ]
      },
      "legs": [
        {
          "distance": 3200,
          "duration": 420,
          "steps": []
        }
      ]
    }
  ],
  "waypoints": [
    {
      "name": "Example road",
      "location": [
        49.8516,
        40.3777
      ],
      "distance": 4.2,
      "trips_index": 0,
      "waypoint_index": 0
    }
  ]
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "code": "InvalidQuery",
  "error": "Coordinates must be finite longitude,latitude pairs."
}

Desteklenen profili seçin. Araç profiline otomatik geçiş yapılmaz.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

API, seçili profil için tüm noktaları aynı yol ağında işleyemedi. Bağlantılı etapları ayrı isteklerle gönderin.

HTTP 422
{
  "code": "CrossRegionNotSupported",
  "error": "These coordinates are not served by one routing graph. Split the request by region."
}

Noktaların erişilebilir yollara yakın ve bu yolların seçili profil için bağlantılı olduğunu kontrol edin.

HTTP 422
{
  "code": "NoNearbyRoad",
  "error": "No connected route within 2000 metres of the requested coordinates."
}

Hizmet veya veri kaynağı kullanılamıyor. Bekleme süresini artırarak dikkatle yeniden deneyin.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Yanıt Yapısının Açıklaması

trips[]: distance — mesafe (m), duration — süre (s), geometry — geometri; waypoints[]: trips_index, waypoint_index — sıra indeksleri, location [lon,lat] — koordinatlar.

Directions API

#

İki veya daha fazla nokta arasında adım adım navigasyon döndürür — temiz bir talimat listesiyle (metin, mesafe, süre, manevra türü ve konum). Araç, bisiklet ve yayanın yanı sıra tek çağrıda 3’e kadar alternatif rota destekler.

GET
/api/1/directions

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
pointstringZorunlulat,lngNokta: lat,lng. Her durak için parametreyi tekrarlayın (en az 2).
profilestringİsteğe bağlıdrivingUlaşım türü: driving, cycling veya walking.
alternativesintegerİsteğe bağlı0Ayrıca döndürülecek alternatif rota sayısı (0–3).
langstringİsteğe bağlıenTalimat metni için dil kodu.

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Directions API
curl "https://osrmroute.com/api/1/directions?point=40.3777,49.8516&point=40.40,49.86&profile=driving" -H "Authorization: Bearer YOUR_KEY"
Alternative Routes API
curl "https://osrmroute.com/api/1/directions?point=40.3777,49.8516&point=40.40,49.86&alternatives=2" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: Her 10 giriş noktası için 1 kredi, yukarı yuvarlanır; başlangıç ve varış dahildir.

Route, Directions ve Truck Routing: işlenen istekte yakında erişilebilir yol veya bağlantılı rota bulunamazsa PAYG dahil uygun tüm planlarda bir kez 0,5 kredi alınır. Geçersiz girdi, erişim/plan veya desteklenmeyen yol ağı kapsamı nedeniyle ret ve sunucu hataları ücretsizdir. Önce başarılı isteğin bedeli rezerve edilir; kullanılmayan kısım iade edilir.

Giriş point=lat,lng. Yönerge/durak konumları: [lat,lng]; GeoJSON: [lon,lat].

  • point: repeat ≥ 2; count ≤ plan.maxRoutePoints
  • alternatives: 0–3

Sürüş, yürüyüş ve bisiklet küreseldir. Noktalar seçilen ulaşım türüne uygun yollarla bağlanmalıdır. VRP sezgiseldir, izokronlar yaklaşıktır; küresel optimum veya canlı trafik vaat edilmez.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "code": "Ok",
  "profile": "driving",
  "routes": [
    {
      "distance": 3200,
      "duration": 420,
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            49.8516,
            40.3777
          ],
          [
            49.86,
            40.4
          ]
        ]
      },
      "instructions": [
        {
          "text": "Continue on Example road",
          "type": "continue",
          "modifier": "straight",
          "distance": 300,
          "duration": 40,
          "name": "Example road",
          "bearing_after": 90,
          "location": [
            40.3777,
            49.8516
          ]
        }
      ]
    }
  ],
  "waypoints": [
    {
      "name": "Example road",
      "location": [
        40.3777,
        49.8516
      ]
    }
  ]
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "At least two points must be provided (point=lat,lng repeated)."
}

Desteklenen profili seçin. Araç profiline otomatik geçiş yapılmaz.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

API, seçili profil için tüm noktaları aynı yol ağında işleyemedi. Bağlantılı etapları ayrı isteklerle gönderin.

HTTP 422
{
  "code": "CrossRegionNotSupported",
  "error": "These coordinates are not served by one routing graph. Split the request by region."
}

Noktaların erişilebilir yollara yakın ve bu yolların seçili profil için bağlantılı olduğunu kontrol edin.

HTTP 422
{
  "code": "NoNearbyRoad",
  "error": "No connected route within 2000 metres of the requested coordinates."
}

Hizmet veya veri kaynağı kullanılamıyor. Bekleme süresini artırarak dikkatle yeniden deneyin.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Yanıt Yapısının Açıklaması

{ code, profile, routes[], waypoints[] } döndürür. Her rotada distance (m), duration (sn), GeoJSON geometri ve instructions[] dizisi vardır; her talimat text, type, modifier, distance, duration, name ve [lat,lng] location içerir.

Snap to Road API

#

Ham, hatalı GPS noktalarını yol ağındaki en yakın konuma yapıştırır. Her koordinat için point parametresini tekrarlayın (en fazla 100).

GET
/api/1/snap

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
pointstringZorunlulat,lngGPS noktası: lat,lng. Her nokta için parametreyi tekrarlayın (en fazla 100).
profilestringİsteğe bağlıdrivingYapıştırılacak yol ağı: driving, cycling veya walking.

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Snap to Road API
curl "https://osrmroute.com/api/1/snap?point=40.3778,49.8517&point=40.3801,49.8600" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: 1 credit

point=lat,lng; JSON noktaları: [lat,lng]. GeoJSON geometrisi: [lon,lat].

  • point: repeat 1–100

Sürüş, yürüyüş ve bisiklet küreseldir. Noktalar seçilen ulaşım türüne uygun yollarla bağlanmalıdır. VRP sezgiseldir, izokronlar yaklaşıktır; küresel optimum veya canlı trafik vaat edilmez.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "code": "Ok",
  "profile": "driving",
  "snapped": [
    {
      "input": [
        40.3777,
        49.8516
      ],
      "snapped": [
        40.3778,
        49.8517
      ],
      "distance": 14,
      "name": "Example road"
    }
  ]
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "At least one point must be provided (point=lat,lng repeated)."
}

Desteklenen profili seçin. Araç profiline otomatik geçiş yapılmaz.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

Noktaların erişilebilir yollara yakın ve bu yolların seçili profil için bağlantılı olduğunu kontrol edin.

HTTP 422
{
  "code": "NoNearbyRoad",
  "error": "No connected route within 2000 metres of the requested coordinates."
}

Hizmet veya veri kaynağı kullanılamıyor. Bekleme süresini artırarak dikkatle yeniden deneyin.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Yanıt Yapısının Açıklaması

{ code, profile, snapped[] } döndürür. Her öğe orijinal input [lat,lng], yapıştırılmış [lat,lng] konum, metre cinsinden yapışma mesafesi ve yol adını içerir.

Geocoding API

#

Bir arama metnini coğrafi koordinatlara (ileri) veya koordinatları bir adrese (ters) dönüştürür. Sokakları, adresleri ve ilgi noktalarını (kafe, mağaza, otel, ofis) kapsayan hızlı, yazım hatasına toleranslı otomatik tamamlama. Yazarken arama için idealdir.

GET
/api/1/geocode

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
qstringİsteğe bağlı-Aranacak adres (örn: "Nizami Caddesi, Bakü").
reversebooleanİsteğe bağlıfalseTers geocoding (koordinattan adrese arama) yapmak için true olmalıdır.
pointstringİsteğe bağlılat,lngAdrese çevirmek için koordinat (lat,lng). reverse=true olduğunda gereklidir.
limitintegerİsteğe bağlı5Döndürülecek maksimum sonuç sayısı (1–20, varsayılan 5).
langstringİsteğe bağlıenSonuç adları için tercih edilen dil (ör. en, az, ru). Varsayılan en.
latnumberİsteğe bağlı-Sonuçları yönlendirmek için enlem (yakınlar önce). lon ile birlikte.
lonnumberİsteğe bağlı-Sonuçları yönlendirmek için boylam. lat ile birlikte.
bboxstringİsteğe bağlı-Sonuçları sınırlayıcı kutuyla kısıtla: minLon,minLat,maxLon,maxLat.
osm_tagstringİsteğe bağlı-OSM etiketine göre filtrele, örn. place (yerleşimler) veya amenity:cafe. Hariç tutmak için ! öneki.
countrystringİsteğe bağlı-ISO 3166-1 alpha-2 ülke kodu, örneğin AZ. Yalnızca bu ülkedeki sonuçlar döner.
citystringİsteğe bağlı-Kesin şehir filtresi, örneğin Bakü. Tam olarak bir country kodu gerektirir.
elasticbooleanİsteğe bağlıtrueEsnek (bulanık, yüksek kapsam) arama — varsayılan true. Yazım hatalarına, eksik diyakritiklere (ə↔e), sözcük sırasına, genel sözcüklere (metro, rayonu) ve kapı numaralarına toleranslıdır. Katı eşleşme için false.

Ülke ve şehir filtreleri

country yoksa arama geneldir. country=AZ yalnızca Azerbaycan, country=AZ&city=Bakı yalnızca Azerbaycan’daki Bakü için sonuç verir. Eşleşme yoksa başka bölgeye geçmeden HTTP 200 ve boş liste döner. Ülkesiz şehir veya geçersiz ülke kodu HTTP 400 InvalidGeocodeFilter döndürür. lat/lon yalnızca yakınlık sıralamasını etkiler. Şehri doğrulanamayan kayıtlar şehir filtresinde gösterilmez.

Örnekler
GET /api/1/geocode?q=Nizami&country=AZ
GET /api/1/geocode?q=Nizami&country=AZ&city=Bak%C4%B1

HTTP 200: { "hits": [], "took": 12 }
HTTP 400: { "code": "InvalidGeocodeFilter", "error": "city requires exactly one country, for example country=AZ&city=Bakı." }

Örnekler

Örnekler
# Bir konuma yönlendir, yalnızca yerleşimler
GET /api/1/geocode?q=qala&lat=40.41&lon=49.87&osm_tag=place

# Yalnızca seçilen ülke ve şehir
GET /api/1/geocode?q=market&country=AZ&city=Bak%C4%B1

# Ters geocode (koordinattan adrese)
GET /api/1/geocode?reverse=true&point=40.409,49.867

Tam adres araması için sokak ve bina numarasını q içinde gönderin. locality ve postcode için tek bir ülke gerekir. unit, kaynakta belirtilen birimi tam eşleştirir ve address_mode=units modunu etkinleştirir. Varsayılan buildings modu aynı konumdaki birim kayıtlarını gruplar.

GET
/api/1/geocode?q=101+Main+Street&country=US&locality=Boston&postcode=02129&unit=2&address_mode=units

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Geocoding API
curl "https://osrmroute.com/api/1/geocode?q=Nizami&country=AZ&city=Bak%C4%B1&lang=az" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: 1 credit

point=lat,lng; JSON noktaları: [lat,lng]. GeoJSON geometrisi: [lon,lat].

  • limit: 1–20
  • reverse: max_distance_m = 1000
  • city: exactly 1 country

Eşleşme yoksa başarılı yanıt boş liste içerebilir. Ülke/şehir filtreleri genişletilmez. Adres ayrıntıları indekslenmiş verilere bağlıdır.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "hits": [
    {
      "name": "Nizami Street",
      "city": "Baku",
      "country": "Azerbaijan",
      "countrycode": "AZ",
      "point": {
        "lat": 40.3777,
        "lng": 49.8516
      }
    }
  ],
  "took": 12
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "The \"q\" parameter (search text) is required."
}

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "code": "InvalidGeocodeFilter",
  "error": "city requires exactly one country, for example country=AZ&city=Bakı."
}

Ters arama yarıçapında indekslenmiş adres veya yer yok.

HTTP 422
{
  "code": "NoNearbyAddress",
  "error": "No indexed address or place within 1 km."
}

Yanıt Yapısının Açıklaması

hits[]: name, city, country, countrycode — yer ve ülke bilgileri, point (lat,lng) — koordinatlar; took — süre (ms). reverse=true: source — kaynak, accuracy — doğruluk, distance_m — mesafe.

Yerler (Yakın POI)

#

Bir konumun yakınındaki ilgi noktalarını bul — kafeler, mağazalar, oteller, ATMler, eczaneler ve daha fazlası — kategori ve yarıçapa göre süzülmüş, mesafeye göre sıralı.

GET
/api/1/places

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
pointstringZorunlulat,lngAranacak merkez koordinatı lat,lng (gerekli).
radiusnumberİsteğe bağlı1Kilometre cinsinden arama yarıçapı (0.05–20, varsayılan 1).
categorystringİsteğe bağlı-OSM etiket filtresi, ör. amenity:cafe, shop, tourism:hotel. Hariç tutmak için !. Boş = tüm POIler.
limitintegerİsteğe bağlı10Maks. sonuç (1–50, varsayılan 10).
langstringİsteğe bağlıenAdlar için tercih edilen dil (ör. en, az, ru).

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Places API
curl "https://osrmroute.com/api/1/places?point=40.371,49.845&radius=1&category=amenity:cafe" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: 1 credit

point=lat,lng; JSON noktaları: [lat,lng]. GeoJSON geometrisi: [lon,lat].

  • radius: 0.05–20 km
  • limit: 1–50

Eşleşme yoksa başarılı yanıt boş liste içerebilir. Ülke/şehir filtreleri genişletilmez. Adres ayrıntıları indekslenmiş verilere bağlıdır.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "places": [
    {
      "name": "Example cafe",
      "category": "amenity",
      "type": "cafe",
      "distance_m": 85,
      "point": {
        "lat": 40.3777,
        "lng": 49.8516
      }
    }
  ],
  "took": 12
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "The \"point\" parameter (lat,lng) is required."
}

Hizmet veya veri kaynağı kullanılamıyor. Bekleme süresini artırarak dikkatle yeniden deneyin.

HTTP 502
{
  "error": "Places service unavailable."
}

Yanıt Yapısının Açıklaması

places[]: name, category, type — yer bilgileri, distance_m — mesafe, point (lat,lng) — koordinatlar; took — süre (ms).

Autocomplete API

#

Kullanıcı yazarken hızlı, yazım hatasına toleranslı yer önerileri (konum ağırlığı ile).

GET
/api/1/autocomplete

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
qstringZorunlu-Arama metni — kısmi giriş olabilir.
limitintegerİsteğe bağlı8Döndürülecek maksimum öneri sayısı (1–15).
langstringİsteğe bağlıenSonuç etiketleri için dil kodu.
latnumberİsteğe bağlı-Sonuçları ağırlıklandırmak için enlem (opsiyonel).
lonnumberİsteğe bağlı-Sonuçları ağırlıklandırmak için boylam (opsiyonel).
countrystringİsteğe bağlı-ISO 3166-1 alpha-2 ülke kodu, örneğin AZ. Yalnızca bu ülkedeki sonuçlar döner.
citystringİsteğe bağlı-Kesin şehir filtresi, örneğin Bakü. Tam olarak bir country kodu gerektirir.
osm_tagstringİsteğe bağlı-Önerileri OSM türüne göre filtrele, örn. place:city.

Ülke ve şehir filtreleri

country yoksa arama geneldir. country=AZ yalnızca Azerbaycan, country=AZ&city=Bakı yalnızca Azerbaycan’daki Bakü için sonuç verir. Eşleşme yoksa başka bölgeye geçmeden HTTP 200 ve boş liste döner. Ülkesiz şehir veya geçersiz ülke kodu HTTP 400 InvalidGeocodeFilter döndürür. lat/lon yalnızca yakınlık sıralamasını etkiler. Şehri doğrulanamayan kayıtlar şehir filtresinde gösterilmez.

Örnekler
GET /api/1/autocomplete?q=Nizami&country=AZ
GET /api/1/autocomplete?q=Nizami&country=AZ&city=Bak%C4%B1

HTTP 200: { "suggestions": [], "took": 12 }
HTTP 400: { "code": "InvalidGeocodeFilter", "error": "city requires exactly one country, for example country=AZ&city=Bakı." }

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Autocomplete API
curl "https://osrmroute.com/api/1/autocomplete?q=niz&lang=az&lat=40.40&lon=49.86" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: 1 credit

point=lat,lng; JSON noktaları: [lat,lng]. GeoJSON geometrisi: [lon,lat].

  • limit: 1–15
  • city: exactly 1 country

Eşleşme yoksa başarılı yanıt boş liste içerebilir. Ülke/şehir filtreleri genişletilmez. Adres ayrıntıları indekslenmiş verilere bağlıdır.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "suggestions": [
    {
      "name": "Nizami Street",
      "city": "Baku",
      "country": "Azerbaijan",
      "countrycode": "AZ",
      "point": {
        "lat": 40.3777,
        "lng": 49.8516
      },
      "label": "Nizami Street, Baku, Azerbaijan"
    }
  ],
  "took": 12
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "The \"q\" parameter (search text) is required."
}

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "code": "InvalidGeocodeFilter",
  "error": "city requires exactly one country, for example country=AZ&city=Bakı."
}

Yanıt Yapısının Açıklaması

{ suggestions[], took } döndürür. Her öneri label, name, city, state, country, countrycode, type, osm_id ve point {lat,lng} içerir.

Batch Geocoding API

#

Tek istekte en fazla 100 adresi coğrafi kodlayın. Sonuçlar giriş sırasıyla döner ve her adres sorgusu bir krediye mal olur.

POST
/api/1/geocode/batch

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
queriesarrayZorunlu[]Coğrafi kodlanacak adres dizisi (maks 100).
langstringİsteğe bağlıenSonuç etiketleri için dil kodu.
limitintegerİsteğe bağlı1Sorgu başına maksimum eşleşme sayısı (1–5).

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Batch Geocoding API
curl -X POST "https://osrmroute.com/api/1/geocode/batch" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"queries":["Nizami küçəsi 10","28 May, Bakı"],"lang":"az"}'

Limitler ve koordinatlar

Kredi maliyeti: 1 credit / query

JSON alan adlarına bakın; bu istek koordinat çifti gerektirmez.

  • queries: 1–100
  • limit: 1–5 / query
  • credits = queries.length

Eşleşme yoksa başarılı yanıt boş liste içerebilir. Ülke/şehir filtreleri genişletilmez. Adres ayrıntıları indekslenmiş verilere bağlıdır.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "results": [
    {
      "query": "Baku",
      "hits": [
        {
          "name": "Nizami Street",
          "city": "Baku",
          "country": "Azerbaijan",
          "countrycode": "AZ",
          "point": {
            "lat": 40.3777,
            "lng": 49.8516
          }
        }
      ]
    }
  ],
  "count": 1,
  "took": 12
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "Body must include a non-empty \"queries\" array of address strings."
}

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "A maximum of 100 queries can be geocoded per batch request."
}

Yanıt Yapısının Açıklaması

{ results[], count, took } döndürür. Her sonuç giriş sorgusunu hits[] dizisiyle eşleştirir; her eşleşme label, city, country ve point {lat,lng} içerir. Sonuçlar giriş sırasını korur.

Timezone API

#

Dünyadaki herhangi bir koordinat için IANA saat dilimi, güncel UTC farkı, DST durumu ve yerel saat.

GET
/api/1/timezone

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
pointstringİsteğe bağlı-point=lat,lng veya birlikte lat ve lon gönderin.
latnumberİsteğe bağlı-Enlem (point yerine).
lonnumberİsteğe bağlı-Boylam (point yerine).
timestampstringİsteğe bağlınowFarkın çözüleceği Unix zamanı (saniye) veya ISO tarih; varsayılan şimdi.

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Timezone API
curl "https://osrmroute.com/api/1/timezone?point=40.4093,49.8671" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: 1 credit

point=lat,lng; JSON noktaları: [lat,lng]. GeoJSON geometrisi: [lon,lat].

  • timestamp: Unix seconds | ISO 8601; default = now
  • utc_offset_seconds: seconds

Giriş biçimini ve örnekteki alan birimlerini doğrulayın.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "timezone": "Asia/Baku",
  "point": {
    "lat": 40.3777,
    "lng": 49.8516
  },
  "utc_offset": "+04:00",
  "utc_offset_seconds": 14400,
  "dst": false,
  "abbreviation": "GMT+4",
  "local_time": "2026-01-01T16:00:00",
  "utc_time": "2026-01-01T12:00:00.000Z"
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "Provide a valid coordinate via point=lat,lng or lat= & lon=."
}

Yanıt Yapısının Açıklaması

{ timezone, point, utc_offset, utc_offset_seconds, dst, abbreviation, local_time, utc_time } döndürür. utc_offset bir +HH:MM dizesidir, yaz saati aktifse dst true olur, local_time ise dilim farkıyla ISO zaman damgasıdır.

Elevation API

#

Herhangi bir koordinat için deniz seviyesinden yükseklik (metre) — tek nokta ya da tüm rota profili.

GET
/api/1/elevation

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
pointstringZorunlulat,lngKoordinat: lat,lng. Her nokta için tekrarlayın (GET’te en fazla 100).

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Elevation API
curl "https://osrmroute.com/api/1/elevation?point=40.4093,49.8671&point=41.30,48.50" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: 1 credit / 10 points

point=lat,lng; JSON noktaları: [lat,lng]. GeoJSON geometrisi: [lon,lat].

  • GET: point count = 1–100
  • POST: points count = 1–1000
  • credits = max(1, ceil(points / 10))
  • elevation: number | null
  • GET with 1 point: elevation alias

Veri yoksa yükseklik null olabilir. Eksik yüksekliği sıfırla değiştirmeyin.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "results": [
    {
      "point": {
        "lat": 40.3777,
        "lng": 49.8516
      },
      "elevation": null
    }
  ],
  "unit": "meters"
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "Provide at least one point=lat,lng (repeatable)."
}

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "A maximum of 100 points can be queried per GET request; use POST for larger batches."
}

Yanıt Yapısının Açıklaması

{ results[], unit:"meters" } döndürür; her sonuç { point:{lat,lng}, elevation }. elevation deniz seviyesinden metredir (bilinmiyorsa null, denizde 0). Tek nokta için üst düzeyde elevation da bulunur. Büyük yığınlar için POST { points:[[lat,lng],...] } (1000’e kadar).

Boundary Lookup API

#

Bir koordinatın hangi ülke, eyalet, şehir ve ilçeye düştüğünü bulun — istenirse sınır poligonuyla.

GET
/api/1/boundary

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
pointstringZorunlulat,lngKoordinat: lat,lng.
polygonbooleanİsteğe bağlıfalseSınırı GeoJSON olarak da döndürmek için true.
langstringİsteğe bağlıenYer adları için dil kodu.

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Boundary Lookup API
curl "https://osrmroute.com/api/1/boundary?point=40.4093,49.8671" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: 1 credit

point=lat,lng; JSON noktaları: [lat,lng]. GeoJSON geometrisi: [lon,lat].

  • polygon: true | false
  • HTTP 422: BoundaryCoverageUnavailable

Ayrıntılı sınırlar yalnızca kabul edilmiş bölgesel veri kümelerinde bulunur. Diğer noktalar BoundaryCoverageUnavailable döndürür.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "point": {
    "lat": 40.3777,
    "lng": 49.8516
  },
  "display_name": "Baku, Azerbaijan",
  "boundary_scope": "city",
  "country": "Azerbaijan",
  "countrycode": "AZ",
  "city": "Baku",
  "boundary": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          49.84,
          40.37
        ],
        [
          49.87,
          40.37
        ],
        [
          49.87,
          40.4
        ],
        [
          49.84,
          40.37
        ]
      ]
    ]
  }
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "Provide a valid coordinate via point=lat,lng or lat= & lon=."
}

Ayrıntılı idari veri burada yok. Hizmet kapsamına bakın.

HTTP 422
{
  "code": "BoundaryCoverageUnavailable",
  "error": "Detailed administrative boundary data is not available at this coordinate."
}

Yanıt Yapısının Açıklaması

{ point, display_name, country, countrycode, state, county, city, district, postcode, osm_id, osm_type } döndürür ve polygon=true olduğunda GeoJSON sınır geometrisi.

Geofencing API

#

Tek çağrıda her noktanın hangi bölgelerinize düştüğünü test edin — poligon veya dairesel çitler.

POST
/api/1/geofence

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
fencesarrayZorunlu[]Çit dizisi: { id?, polygon:[[lat,lng],...] } veya { id?, center:[lat,lng], radius_m }. En fazla 100.
pointsarrayZorunlu[]Test edilecek [lat,lng] noktaları dizisi (en fazla 1000).

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Geofencing API
curl -X POST "https://osrmroute.com/api/1/geofence" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fences":[{"id":"zone1","polygon":[[40.40,49.85],[40.43,49.85],[40.43,49.90],[40.40,49.90]]}],"points":[[40.41,49.87],[40.50,50.10]]}'

Limitler ve koordinatlar

Kredi maliyeti: 1 credit / 100 points

point=lat,lng; JSON noktaları: [lat,lng]. GeoJSON geometrisi: [lon,lat].

  • fences: 1–100
  • points: 1–1000
  • credits = max(1, ceil(points / 100))

Giriş biçimini ve örnekteki alan birimlerini doğrulayın.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "results": [
    {
      "point": {
        "lat": 40.3777,
        "lng": 49.8516
      },
      "inside": [
        "depot"
      ]
    }
  ],
  "count": 1,
  "took": 1
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "Body must include non-empty \"fences\" and \"points\" arrays."
}

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "Limits: up to 100 fences and 1000 points per request."
}

Yanıt Yapısının Açıklaması

{ results[], count } döndürür. Her sonuç { point:{lat,lng}, inside:[fenceId,...] } — noktanın düştüğü tüm çitleri listeler (yoksa boş).

Elevation Profile API

#

Yolun her noktasında yükseklik + toplam tırmanma, iniş ve mesafe — tam rota profili.

POST
/api/1/elevation/profile

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
pointsarrayİsteğe bağlı[]Yolu oluşturan [lat,lng] noktaları dizisi (>=2, en fazla 2000).
polylinestringİsteğe bağlı-points yerine kodlanmış polyline.

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Elevation Profile API
curl -X POST "https://osrmroute.com/api/1/elevation/profile" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"points":[[40.37,49.85],[40.80,48.90],[41.30,48.05]]}'

Limitler ve koordinatlar

Kredi maliyeti: 1 credit / 10 points

point=lat,lng; JSON noktaları: [lat,lng]. GeoJSON geometrisi: [lon,lat].

  • points: 2–2000
  • credits = max(1, ceil(points / 10))
  • elevation: number | null

Veri yoksa yükseklik null olabilir. Eksik yüksekliği sıfırla değiştirmeyin.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "profile": [
    {
      "point": {
        "lat": 40.3777,
        "lng": 49.8516
      },
      "elevation": null,
      "distance": 0
    },
    {
      "point": {
        "lat": 40.4,
        "lng": 49.86
      },
      "elevation": null,
      "distance": 2590
    }
  ],
  "total_ascent": 0,
  "total_descent": 0,
  "min_elevation": null,
  "max_elevation": null,
  "distance": 2590,
  "unit": "meters",
  "took": 12
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "Provide a \"points\" array (>=2 [lat,lng]) or an encoded \"polyline\"."
}

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "A maximum of 2000 points is allowed per request."
}

Yanıt Yapısının Açıklaması

{ profile[], total_ascent, total_descent, min_elevation, max_elevation, distance, unit } döndürür. Her öğe { point, elevation, distance } (metre).

Solar API

#

Herhangi bir koordinat ve tarih için gün doğumu, gün batımı, alacakaranlık, öğle ve gün uzunluğu.

GET
/api/1/solar

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
pointstringZorunlulat,lngKoordinat: lat,lng.
datestringİsteğe bağlıtodaySürelerin hesaplanacağı tarih (YYYY-MM-DD); varsayılan bugün.

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Solar API
curl "https://osrmroute.com/api/1/solar?point=40.4093,49.8671&date=2026-07-07" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: 1 credit

point=lat,lng; JSON noktaları: [lat,lng]. GeoJSON geometrisi: [lon,lat].

  • date: YYYY-MM-DD; default = today
  • times: UTC ISO 8601 | null

Kutup gündüzü veya gecesinde güneş saatleri null olabilir. Saatler UTC biçimindedir.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "point": {
    "lat": 40.3777,
    "lng": 49.8516
  },
  "date": "2026-01-01",
  "sunrise": "2026-01-01T04:00:00.000Z",
  "sunset": "2026-01-01T13:00:00.000Z",
  "solar_noon": "2026-01-01T08:30:00.000Z",
  "day_length_seconds": 32400
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "Provide a valid coordinate via point=lat,lng or lat= & lon=."
}

Yanıt Yapısının Açıklaması

{ point, date, sunrise, sunset, solar_noon, dawn, dusk, golden_hour, night_start, night_end, day_length_seconds } döndürür. Süreler UTC ISO; kutup gece/gündüzünde null.

Geometry Utilities API

#

Mesafe, kerteriz, alan, merkez, sadeleştirme ve polyline encode/decode — mekânsal matematik servis olarak.

POST
/api/1/geometry

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
opstringZorunludistanceİşlem: distance, bearing, destination, midpoint, length, area, centroid, simplify, polyline_encode veya polyline_decode.
fromarrayİsteğe bağlı[lat,lng]Başlangıç noktası [lat,lng].
toarrayİsteğe bağlı[lat,lng]Bitiş noktası [lat,lng].
patharrayİsteğe bağlı[][lat,lng] dizisi (length/simplify/polyline_encode).
polygonarrayİsteğe bağlı[][lat,lng] halkası (area).
op → JSON
distance, bearing, midpoint → from, to
destination → from, bearing (°), distance_m
length → path (≥ 2)
area → polygon (≥ 3)
centroid → points (≥ 1)
simplify → path (2–2000), tolerance_m (10)
polyline_encode → path (≥ 1), precision (5)
polyline_decode → polyline, precision (5)

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Geometry Utilities API
curl -X POST "https://osrmroute.com/api/1/geometry" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"op":"distance","from":[40.37,49.85],"to":[40.40,49.86]}'

Limitler ve koordinatlar

Kredi maliyeti: 1 credit

point=lat,lng; JSON noktaları: [lat,lng]. GeoJSON geometrisi: [lon,lat].

  • op: distance | bearing | destination | midpoint | length | area | centroid | simplify | polyline_encode | polyline_decode

Giriş biçimini ve örnekteki alan birimlerini doğrulayın.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "op": "distance",
  "distance": 2590.25,
  "unit": "meters"
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "Invalid geometry input for the requested op."
}

Yanıt Yapısının Açıklaması

{ op, ... } döndürür — seçilen işlemin sonucuyla, örn. { distance, unit }, { bearing_deg }, { point }, { area, unit }, { path } veya { polyline }.

Coordinate Conversion API

#

Enlem/boylamı UTM ve MGRS ızgara referanslarına ve tersine dönüştür.

GET
/api/1/convert

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
pointstringİsteğe bağlılat,lngUTM/MGRS’e dönüştürülecek koordinat: lat,lng.
mgrsstringİsteğe bağlı-Koordinata geri dönüştürülecek MGRS dizesi.

point=lat,lng, birlikte lat ve lon ya da mgrs gönderin. Boş olmayan mgrs önceliklidir. Ters dönüşüm MGRS hücresinin merkezini döndürür ve utm alanını içermez.

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Coordinate Conversion API
curl "https://osrmroute.com/api/1/convert?point=40.3755,49.8516" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: 1 credit

point=lat,lng; JSON noktaları: [lat,lng]. GeoJSON geometrisi: [lon,lat].

  • point=lat,lng OR (lat=... AND lon=...) OR mgrs=...

Giriş biçimini ve örnekteki alan birimlerini doğrulayın.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "point": {
    "lat": 40.3755,
    "lng": 49.8516
  },
  "mgrs": "39TVE0251070068",
  "utm": {
    "zone": 39,
    "band": "T",
    "easting": 402511,
    "northing": 4470068,
    "hemisphere": "N"
  }
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "Provide point=lat,lng (or lat= & lon=), or mgrs= to reverse-convert."
}

Yanıt Yapısının Açıklaması

{ point, mgrs, utm:{ zone, band, easting, northing, hemisphere } } döndürür. mgrs= verildiğinde { mgrs, point }.

Country Info API

#

Herhangi bir ülke için para birimi, arama kodu, diller, başkent ve bayrak — ISO kodu veya adıyla.

GET
/api/1/country

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
codestringİsteğe bağlıAZISO 3166 alpha-2 veya alpha-3 ülke kodu (örn. AZ veya AZE).
namestringİsteğe bağlı-Kod yerine ülke adı.

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Country Info API
curl "https://osrmroute.com/api/1/country?code=AZ" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: 1 credit

JSON alan adlarına bakın; bu istek koordinat çifti gerektirmez.

  • code=ISO2/ISO3 OR name=...

Giriş biçimini ve örnekteki alan birimlerini doğrulayın.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "name": "Azerbaijan",
  "official_name": "Republic of Azerbaijan",
  "cca2": "AZ",
  "cca3": "AZE",
  "capital": "Baku",
  "region": "Asia",
  "subregion": "Western Asia",
  "currency": {
    "code": "AZN",
    "name": "Azerbaijani manat",
    "symbol": "₼"
  },
  "calling_code": "+994",
  "languages": [
    "Azerbaijani"
  ],
  "flag": "🇦🇿",
  "latlng": [
    40.5,
    47.5
  ]
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "Provide code=ISO2/ISO3 or name=CountryName."
}

Geçerli ülke kodunu veya tam ülke adını kullanın.

HTTP 404
{
  "error": "Country not found."
}

Yanıt Yapısının Açıklaması

{ name, official_name, cca2, cca3, capital, region, subregion, currency:{code,name,symbol}, calling_code, languages[], flag, latlng } döndürür.

Isochrone API

#

Örnek noktalara yolculuk sürelerinden erişilebilirliği tahmin eder. Her yönde ulaşılabilir bir nokta varsa quality.status estimated olur; aksi halde insufficient_data ve boş polygons döner. Boş sonuç, ulaşılabilir yol olmadığını kanıtlamaz. Sınır yaklaşık hesaplanır; yalnızca süre sınırı desteklenir.

GET
/api/1/isochrone

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
pointstringZorunlu-Merkez nokta. Biçim: lat,lon.
time_limitintegerİsteğe bağlı600Seyahat süresi limiti (saniye cinsinden).

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Isochrones API
curl "https://osrmroute.com/api/1/isochrone?point=40.4093,49.8671&time_limit=600" -H "Authorization: Bearer YOUR_KEY"

Limitler ve koordinatlar

Kredi maliyeti: 2 credits / minute; minimum 10

point=lat,lng; JSON noktaları: [lat,lng]. GeoJSON geometrisi: [lon,lat].

  • time_limit: min = 60 s
  • time_limit ≤ plan.maxIsochroneMinutes × 60
  • quality.status = estimated | insufficient_data; polygons = [] when any bearing lacks a reachable sample
  • Sampled OSRM estimate, not an exact reachable-area boundary; an empty polygon does not prove no reachable roads
  • credits = max(10, ceil(time_limit_seconds / 30))

Sürüş, yürüyüş ve bisiklet küreseldir. Noktalar seçilen ulaşım türüne uygun yollarla bağlanmalıdır. VRP sezgiseldir, izokronlar yaklaşıktır; küresel optimum veya canlı trafik vaat edilmez.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "quality": {
    "status": "estimated",
    "method": "sampled_osrm",
    "sampled_points": 80,
    "reachable_points": 48,
    "covered_bearings": 16,
    "total_bearings": 16,
    "unknown_points": 0
  },
  "polygons": [
    {
      "type": "Feature",
      "properties": {
        "bucket": 0,
        "time_limit": 600
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              49.84,
              40.37
            ],
            [
              49.87,
              40.37
            ],
            [
              49.87,
              40.4
            ],
            [
              49.84,
              40.37
            ]
          ]
        ]
      }
    }
  ]
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "point parameter is required"
}

Planın karmaşıklık limitlerini ve anahtar kısıtlarını kontrol edin.

HTTP 403
{
  "error": "The Isochrone API is not available on your plan. Upgrade your plan to use it."
}

Desteklenen profili seçin. Araç profiline otomatik geçiş yapılmaz.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

Hizmet veya veri kaynağı kullanılamıyor. Bekleme süresini artırarak dikkatle yeniden deneyin.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Yanıt Yapısının Açıklaması

polygons[] — GeoJSON Feature; geometry — Polygon [lon,lat]; properties.time_limit — zaman sınırı (s).

Route Optimization API

#

Kapasite, zaman aralıkları, yetkinlikler ve bağlantılı alım/teslimat kısıtlarıyla filo rotalarını planlar. Süresi sınırlı sezgisel algoritma yolculuk süresini azaltır; küresel optimum garantisi vermez. Atanamayan görevler solution.unassigned içinde kalır; geçersiz girdinin tamamı reddedilir.

POST
/api/1/vrp

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
vehiclesarrayİsteğe bağlıone default vehicleAraç listesi — her biri id, isteğe bağlı kapasite ve [lon, lat] dizisi (önce boylam) olarak bir başlangıç konumu içerir.
servicesarrayİsteğe bağlı[]Hizmet verilecek duraklar — her biri id, [lon, lat] dizisi (önce boylam) olarak konum ve isteğe bağlı hizmet süresi içerir.
shipmentsarrayİsteğe bağlı[]amount ve skills içeren bağlantılı alım ve teslimat görevleri. services, shipments veya ikisini de belirtin; en fazla 250 görev noktası.
profilestringİsteğe bağlıdrivingOrtak ulaşım profili: driving, cycling veya walking; belgelenmiş alternatif adlar da kabul edilir.

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Route Optimization API
curl -X POST "https://osrmroute.com/api/1/vrp" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vehicles":[{"vehicle_id":"v1","start":[49.85,40.37]}],"services":[{"id":10,"location":[49.86,40.40]}]}'

Limitler ve koordinatlar

Kredi maliyeti: max(10, ceil(vehicles * task_points * 13 / 15)) credits

VRP start/location dizileri: [lon,lat]; nesneler: lat ve lng/lon. Süre saniyedir.

  • vehicles.length ≤ plan.maxVehicles
  • vehicles defaults to one vehicle when omitted
  • services.length + 2 × shipments.length ≤ 250; vehicles.length ≤ 100
  • task_points = services.length + 2 × shipments.length
  • credits = max(10, ceil(vehicles * task_points * 13 / 15)); invalid inputs are refunded
  • Capacity arrays, time_windows, skills and paired shipments are enforced; unsupported options return 400
  • solution.unassigned lists tasks not assigned by the bounded heuristic; this is not proof of infeasibility
  • transport_time is travel only; service_time, waiting_time and elapsed time are separate; costs is travel seconds

Sürüş, yürüyüş ve bisiklet küreseldir. Noktalar seçilen ulaşım türüne uygun yollarla bağlanmalıdır. VRP sezgiseldir, izokronlar yaklaşıktır; küresel optimum veya canlı trafik vaat edilmez.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "status": "finished",
  "job_id": "opt-1234567890",
  "processing_time": 0,
  "solution": {
    "unassigned": [],
    "quality": {
      "solver": "vroom",
      "version": "1.15.0",
      "constraints_verified": true,
      "optimality_proven": false
    },
    "costs": 420,
    "distance": 3200,
    "time": 420,
    "no_vehicles": 1,
    "no_unassigned": 0,
    "routes": [
      {
        "vehicle_id": "v1",
        "distance": 3200,
        "transport_time": 420,
        "activities": [
          {
            "type": "start",
            "location_id": "depot",
            "end_time": 0
          },
          {
            "type": "service",
            "id": 10,
            "location_id": "stop_1",
            "arr_time": 200,
            "end_time": 200
          },
          {
            "type": "end",
            "location_id": "depot",
            "arr_time": 420
          }
        ]
      }
    ]
  }
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "code": "InvalidOptimizationInput",
  "error": "At least one service with valid coordinates is required."
}

Planın karmaşıklık limitlerini ve anahtar kısıtlarını kontrol edin.

HTTP 403
{
  "error": "Your plan allows up to 1 vehicles per request. Upgrade your plan for more."
}

Noktaların erişilebilir yollara yakın ve bu yolların seçili profil için bağlantılı olduğunu kontrol edin.

HTTP 422
{
  "code": "NoNearbyRoad",
  "error": "No connected route within 2000 metres of the requested coordinates."
}

Yanıt Yapısının Açıklaması

status → finished; job_id — görev kimliği; solution: distance — mesafe (m), time ve costs — süre (s), no_vehicles, no_unassigned — sayılar, routes[] — rotalar. routes[]: vehicle_id, distance (m), transport_time (s), activities[] — etkinlikler.

Location Clustering API

#

Verilen koordinatları coğrafi yakınlıklarına ve yoğunluklarına göre gruplar (kümelere ayırır).

POST
/api/1/cluster

Parametreler (Query Params)

ParametreTürDurumVarsayılanAçıklama
customersarrayZorunlu[]Kümelenecek müşteri koordinatları ve ağırlıkları.

İstek örneği

YOUR_KEY yerine kendi API anahtarınızı yazın. API istekleri kredi tüketir; örneği kopyalamak istek göndermez.

Konum Kümeleme
curl -X POST "https://osrmroute.com/api/1/cluster" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"customers":[[49.85,40.37],[49.86,40.40],[49.83,40.39]],"clusters":2}'

Limitler ve koordinatlar

Kredi maliyeti: 3 credits

Müşteri giriş dizileri: [lon,lat]; küme merkezi çıkışı: [lat,lon].

  • customers: valid coordinates ≥ 1
  • 1 ≤ clusters ≤ valid_customers.length

Giriş biçimini ve örnekteki alan birimlerini doğrulayın.

Güncel planlar ve fiyatlarHizmete göre kapsam

JSON yanıt örneği

Kısaltılmış, açıklayıcı JSON örneğidir. Değerler, isteğe bağlı alanlar ve harita verileri değişebilir. Aksi belirtilmedikçe mesafeler metre, rota süreleri saniyedir.

HTTP 200 · application/json
{
  "status": "finished",
  "job_id": "cluster-1234567890",
  "processing_time": 0,
  "no_clusters": 1,
  "clusters": [
    {
      "ids": [
        "s1",
        "s2"
      ],
      "center": [
        40.385,
        49.855
      ],
      "size": 2
    }
  ]
}
Hizmete özel hatalar

Eksik veya geçersiz parametreleri düzeltin.

HTTP 400
{
  "error": "Provide a \"customers\" array with valid coordinates."
}

Yanıt Yapısının Açıklaması

status → finished; job_id — görev kimliği; no_clusters — küme sayısı; clusters[]: ids[] — öğeler, center [lat,lon] — merkez, size — boyut.

Uyumluluk uç noktaları

Mevcut entegrasyonu ana API’ye taşımadan önce koordinat sırasını ve yanıt birimlerini kontrol edin.

Kısa Routing adresi standart OSRM ile aynı girdi ve çıktıyı kullanır. Eski Route yinelenen enlem,boylam çiftleri alır. paths[].time milisaniye, paths[].distance metredir. Route info yapılandırılmış kapsamı gösterir ve bir kredi harcar.

HTTP
GET /api/v1/route/driving/49.8516,40.3755;49.8378,40.3892
GET /api/1/route?point=40.3755,49.8516&point=40.3892,49.8378
GET /api/1/route/info

Eski Matrix, yinelenen point parametresi veya from_point ve to_point listelerini alır. JSON için from_points ve to_points alanlarında enlem,boylam çiftleri gönderin. Süreler milisaniye, mesafeler metredir.

HTTP
GET /api/1/matrix?point=40.3755,49.8516&point=40.3892,49.8378
POST /api/1/matrix · POST /api/1/matrix/calculate
{"from_points":[[40.3755,49.8516]],"to_points":[[40.3892,49.8378]]}

Eski Match sıralı GPS izini [lon, lat] çiftleri olarak alır. İsteğe bağlı olarak her nokta için saniye cinsinden zaman ve metre cinsinden yarıçap gönderin. Mesafeler metre, süreler milisaniyedir. Toplu Elevation ([lat, lon]) en çok 1.000 çift alır ve metre veya null döndürür.

POST /api/1/match
{"points":[[49.8516,40.3755],[49.8378,40.3892]],"timestamps":[1760000000,1760000120],"radiuses":[20,20]}
POST /api/1/elevation
{"points":[[40.3755,49.8516],[40.3892,49.8378]]}

optimize ve vrp/optimize VRP ile aynı biçimi kullanır. Kümeleme ve toplu adres arama takma adları ana biçimleri kullanır. VRP ve kümeleme sonucu doğrudan yanıtta döndürür.

Harita Playground

Resmî SDK’lar

Android/JVM için Kotlin, iOS için Swift. Tipli modeller ve asenkron isteklerle OSRMRoute coğrafi API’lerine bağlanın.

JavaScript / TypeScriptPythonKotlin / AndroidSwift / iOSSDK’lara göz at

OSRMRoute Destek

Ekibimize doğrudan yazın

YARDIMA HAZIRIZ

Nasıl yardımcı olabiliriz?

Mesaj gönderin. Talep yanıtları doğrulanmış e-posta adresinize de gönderilir.

Sohbetleriniz

Sohbetleriniz burada görünecek.