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.
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/infoTü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.
Authorization: Bearer YOUR_API_KEYHata 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-AfterGeçerli API anahtarı girin ve panelde durumunu kontrol edin.
{
"error": "Invalid API Key"
}Bakiye yükleyin veya uygun bir plan seçin.
{
"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.
{
"error": "This API Key is disabled"
}Varsa Retry-After değerine uyun ve istek sıklığını azaltın.
{
"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.
{
"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.
/api/v1/osrm/route/v1/{profile}/{coordinates}Parametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| profile | string | Zorunlu | driving | Ulaşım türü profili. Desteklenen değerler: driving (otomobil), cycling (bisiklet), walking (yaya). |
| coordinates | string | Zorunlu | - | Noktaların koordinatları. Biçim: lon,lat;lon,lat;lon,lat... (en az 2 nokta). |
| overview | string | İsteğe bağlı | simplified | Döndürülen rota geometrisinin ayrıntı düzeyi: simplified (sadeleştirilmiş), full (tam geometri), false (geometrisiz). |
| geometries | string | İsteğe bağlı | polyline | Geometri biçimi: geojson (GeoJSON nesnesi), polyline (kodlanmış dize). |
| steps | boolean | İsteğe bağlı | false | Her dönüş için adım adım talimatların döndürülüp döndürülmeyeceği. |
| alternatives | integer | boolean | İsteğe bağlı | false | Aranacak 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.
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 kapsamJSON 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.
{
"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.
{
"code": "InvalidQuery",
"error": "Coordinates must be finite longitude,latitude pairs."
}Desteklenen profili seçin. Araç profiline otomatik geçiş yapılmaz.
{
"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.
{
"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.
{
"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.
{
"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.
/api/v1/osrm/table/v1/{profile}/{coordinates}Parametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| profile | string | Zorunlu | driving | Ulaşım profili (driving, cycling, walking). |
| coordinates | string | Zorunlu | - | Matris noktaları. Biçim: lon,lat;lon,lat;lon,lat... |
| annotations | string | İsteğe bağlı | duration | Hesaplanacak veri: duration (süre), distance (mesafe) veya her ikisi. |
| sources | string | İsteğe bağlı | all | Noktalı virgülle ayrılmış sıfır tabanlı çıkış indisleri veya all. |
| destinations | string | İsteğe bağlı | all | Noktalı 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.
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 kapsamJSON 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.
{
"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.
{
"code": "InvalidQuery",
"error": "Coordinates must be finite longitude,latitude pairs."
}Desteklenen profili seçin. Araç profiline otomatik geçiş yapılmaz.
{
"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.
{
"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.
{
"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.
{
"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.
/api/v1/osrm/match/v1/{profile}/{coordinates}Parametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| geometries | string | İsteğe bağlı | polyline | Geometri biçimi: geojson (GeoJSON nesnesi), polyline (kodlanmış dize). |
| profile | string | Zorunlu | driving | Ulaşım profili. |
| coordinates | string | Zorunlu | - | Hizalanacak GPS koordinatları dizisi (lon,lat;lon,lat...) |
| overview | string | İsteğe bağlı | simplified | Hizalanan rotanın geometri hassasiyeti. |
| timestamps | string | İ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. |
| radiuses | string | İ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.
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 kapsamJSON 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.
{
"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.
{
"code": "InvalidQuery",
"error": "Coordinates must be finite longitude,latitude pairs."
}Desteklenen profili seçin. Araç profiline otomatik geçiş yapılmaz.
{
"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.
{
"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.
{
"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.
{
"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.
/api/v1/osrm/nearest/v1/{profile}/{coordinates}Parametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| profile | string | Zorunlu | driving | Ulaşım profili. |
| coordinates | string | Zorunlu | - | Yakınında arama yapılacak nokta. Biçim: lon,lat (tek çift). |
| number | integer | İsteğe bağlı | 1 | Bulunacak 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.
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 kapsamJSON 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.
{
"code": "Ok",
"waypoints": [
{
"name": "Example road",
"location": [
49.8516,
40.3777
],
"distance": 4.2
}
]
}Hizmete özel hatalar
Eksik veya geçersiz parametreleri düzeltin.
{
"code": "InvalidQuery",
"error": "Coordinates must be finite longitude,latitude pairs."
}Desteklenen profili seçin. Araç profiline otomatik geçiş yapılmaz.
{
"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.
{
"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.
{
"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.
/api/v1/osrm/trip/v1/{profile}/{coordinates}Parametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| geometries | string | İsteğe bağlı | polyline | Geometri biçimi: geojson (GeoJSON nesnesi), polyline (kodlanmış dize). |
| profile | string | Zorunlu | driving | Ulaşım profili. |
| coordinates | string | Zorunlu | - | Ziyaret edilecek noktalar. Biçim: lon,lat;lon,lat... |
| source | string | İsteğe bağlı | any | Rotanın başlayabileceği nokta (any veya ilk nokta). |
| destination | string | İsteğe bağlı | any | Rotanın biteceği nokta (any veya son nokta). |
| roundtrip | boolean | İsteğe bağlı | true | Baş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.
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 kapsamJSON 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.
{
"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.
{
"code": "InvalidQuery",
"error": "Coordinates must be finite longitude,latitude pairs."
}Desteklenen profili seçin. Araç profiline otomatik geçiş yapılmaz.
{
"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.
{
"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.
{
"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.
{
"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.
/api/1/directionsParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| point | string | Zorunlu | lat,lng | Nokta: lat,lng. Her durak için parametreyi tekrarlayın (en az 2). |
| profile | string | İsteğe bağlı | driving | Ulaşım türü: driving, cycling veya walking. |
| alternatives | integer | İsteğe bağlı | 0 | Ayrıca döndürülecek alternatif rota sayısı (0–3). |
| lang | string | İsteğe bağlı | en | Talimat 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.
curl "https://osrmroute.com/api/1/directions?point=40.3777,49.8516&point=40.40,49.86&profile=driving" -H "Authorization: Bearer YOUR_KEY"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 kapsamJSON 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.
{
"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.
{
"error": "At least two points must be provided (point=lat,lng repeated)."
}Desteklenen profili seçin. Araç profiline otomatik geçiş yapılmaz.
{
"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.
{
"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.
{
"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.
{
"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).
/api/1/snapParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| point | string | Zorunlu | lat,lng | GPS noktası: lat,lng. Her nokta için parametreyi tekrarlayın (en fazla 100). |
| profile | string | İsteğe bağlı | driving | Yapış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.
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 kapsamJSON 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.
{
"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.
{
"error": "At least one point must be provided (point=lat,lng repeated)."
}Desteklenen profili seçin. Araç profiline otomatik geçiş yapılmaz.
{
"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.
{
"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.
{
"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.
/api/1/geocodeParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| q | string | İsteğe bağlı | - | Aranacak adres (örn: "Nizami Caddesi, Bakü"). |
| reverse | boolean | İsteğe bağlı | false | Ters geocoding (koordinattan adrese arama) yapmak için true olmalıdır. |
| point | string | İsteğe bağlı | lat,lng | Adrese çevirmek için koordinat (lat,lng). reverse=true olduğunda gereklidir. |
| limit | integer | İsteğe bağlı | 5 | Döndürülecek maksimum sonuç sayısı (1–20, varsayılan 5). |
| lang | string | İsteğe bağlı | en | Sonuç adları için tercih edilen dil (ör. en, az, ru). Varsayılan en. |
| lat | number | İsteğe bağlı | - | Sonuçları yönlendirmek için enlem (yakınlar önce). lon ile birlikte. |
| lon | number | İsteğe bağlı | - | Sonuçları yönlendirmek için boylam. lat ile birlikte. |
| bbox | string | İsteğe bağlı | - | Sonuçları sınırlayıcı kutuyla kısıtla: minLon,minLat,maxLon,maxLat. |
| osm_tag | string | İsteğe bağlı | - | OSM etiketine göre filtrele, örn. place (yerleşimler) veya amenity:cafe. Hariç tutmak için ! öneki. |
| country | string | İsteğe bağlı | - | ISO 3166-1 alpha-2 ülke kodu, örneğin AZ. Yalnızca bu ülkedeki sonuçlar döner. |
| city | string | İsteğe bağlı | - | Kesin şehir filtresi, örneğin Bakü. Tam olarak bir country kodu gerektirir. |
| elastic | boolean | İsteğe bağlı | true | Esnek (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.
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
# 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.867Tam 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.
/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.
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 kapsamJSON 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.
{
"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.
{
"error": "The \"q\" parameter (search text) is required."
}Eksik veya geçersiz parametreleri düzeltin.
{
"code": "InvalidGeocodeFilter",
"error": "city requires exactly one country, for example country=AZ&city=Bakı."
}Ters arama yarıçapında indekslenmiş adres veya yer yok.
{
"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ı.
/api/1/placesParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| point | string | Zorunlu | lat,lng | Aranacak merkez koordinatı lat,lng (gerekli). |
| radius | number | İsteğe bağlı | 1 | Kilometre cinsinden arama yarıçapı (0.05–20, varsayılan 1). |
| category | string | İsteğe bağlı | - | OSM etiket filtresi, ör. amenity:cafe, shop, tourism:hotel. Hariç tutmak için !. Boş = tüm POIler. |
| limit | integer | İsteğe bağlı | 10 | Maks. sonuç (1–50, varsayılan 10). |
| lang | string | İsteğe bağlı | en | Adlar 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.
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 kapsamJSON 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.
{
"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.
{
"error": "The \"point\" parameter (lat,lng) is required."
}Hizmet veya veri kaynağı kullanılamıyor. Bekleme süresini artırarak dikkatle yeniden deneyin.
{
"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).
/api/1/autocompleteParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| q | string | Zorunlu | - | Arama metni — kısmi giriş olabilir. |
| limit | integer | İsteğe bağlı | 8 | Döndürülecek maksimum öneri sayısı (1–15). |
| lang | string | İsteğe bağlı | en | Sonuç etiketleri için dil kodu. |
| lat | number | İsteğe bağlı | - | Sonuçları ağırlıklandırmak için enlem (opsiyonel). |
| lon | number | İsteğe bağlı | - | Sonuçları ağırlıklandırmak için boylam (opsiyonel). |
| country | string | İsteğe bağlı | - | ISO 3166-1 alpha-2 ülke kodu, örneğin AZ. Yalnızca bu ülkedeki sonuçlar döner. |
| city | string | İsteğe bağlı | - | Kesin şehir filtresi, örneğin Bakü. Tam olarak bir country kodu gerektirir. |
| osm_tag | string | İ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.
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.
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 kapsamJSON 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.
{
"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.
{
"error": "The \"q\" parameter (search text) is required."
}Eksik veya geçersiz parametreleri düzeltin.
{
"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.
/api/1/geocode/batchParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| queries | array | Zorunlu | [] | Coğrafi kodlanacak adres dizisi (maks 100). |
| lang | string | İsteğe bağlı | en | Sonuç etiketleri için dil kodu. |
| limit | integer | İsteğe bağlı | 1 | Sorgu 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.
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 kapsamJSON 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.
{
"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.
{
"error": "Body must include a non-empty \"queries\" array of address strings."
}Eksik veya geçersiz parametreleri düzeltin.
{
"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.
/api/1/timezoneParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| point | string | İsteğe bağlı | - | point=lat,lng veya birlikte lat ve lon gönderin. |
| lat | number | İsteğe bağlı | - | Enlem (point yerine). |
| lon | number | İsteğe bağlı | - | Boylam (point yerine). |
| timestamp | string | İsteğe bağlı | now | Farkı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.
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 kapsamJSON 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.
{
"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.
{
"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.
/api/1/elevationParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| point | string | Zorunlu | lat,lng | Koordinat: 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.
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 kapsamJSON 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.
{
"results": [
{
"point": {
"lat": 40.3777,
"lng": 49.8516
},
"elevation": null
}
],
"unit": "meters"
}Hizmete özel hatalar
Eksik veya geçersiz parametreleri düzeltin.
{
"error": "Provide at least one point=lat,lng (repeatable)."
}Eksik veya geçersiz parametreleri düzeltin.
{
"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.
/api/1/boundaryParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| point | string | Zorunlu | lat,lng | Koordinat: lat,lng. |
| polygon | boolean | İsteğe bağlı | false | Sınırı GeoJSON olarak da döndürmek için true. |
| lang | string | İsteğe bağlı | en | Yer 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.
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 kapsamJSON 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.
{
"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.
{
"error": "Provide a valid coordinate via point=lat,lng or lat= & lon=."
}Ayrıntılı idari veri burada yok. Hizmet kapsamına bakın.
{
"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.
/api/1/geofenceParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| fences | array | Zorunlu | [] | Çit dizisi: { id?, polygon:[[lat,lng],...] } veya { id?, center:[lat,lng], radius_m }. En fazla 100. |
| points | array | Zorunlu | [] | 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.
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 kapsamJSON 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.
{
"results": [
{
"point": {
"lat": 40.3777,
"lng": 49.8516
},
"inside": [
"depot"
]
}
],
"count": 1,
"took": 1
}Hizmete özel hatalar
Eksik veya geçersiz parametreleri düzeltin.
{
"error": "Body must include non-empty \"fences\" and \"points\" arrays."
}Eksik veya geçersiz parametreleri düzeltin.
{
"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.
/api/1/elevation/profileParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| points | array | İsteğe bağlı | [] | Yolu oluşturan [lat,lng] noktaları dizisi (>=2, en fazla 2000). |
| polyline | string | İ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.
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 kapsamJSON 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.
{
"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.
{
"error": "Provide a \"points\" array (>=2 [lat,lng]) or an encoded \"polyline\"."
}Eksik veya geçersiz parametreleri düzeltin.
{
"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.
/api/1/solarParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| point | string | Zorunlu | lat,lng | Koordinat: lat,lng. |
| date | string | İsteğe bağlı | today | Sü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.
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 kapsamJSON 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.
{
"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.
{
"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.
/api/1/geometryParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| op | string | Zorunlu | distance | İşlem: distance, bearing, destination, midpoint, length, area, centroid, simplify, polyline_encode veya polyline_decode. |
| from | array | İsteğe bağlı | [lat,lng] | Başlangıç noktası [lat,lng]. |
| to | array | İsteğe bağlı | [lat,lng] | Bitiş noktası [lat,lng]. |
| path | array | İsteğe bağlı | [] | [lat,lng] dizisi (length/simplify/polyline_encode). |
| polygon | array | İsteğe bağlı | [] | [lat,lng] halkası (area). |
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.
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 kapsamJSON 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.
{
"op": "distance",
"distance": 2590.25,
"unit": "meters"
}Hizmete özel hatalar
Eksik veya geçersiz parametreleri düzeltin.
{
"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.
/api/1/convertParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| point | string | İsteğe bağlı | lat,lng | UTM/MGRS’e dönüştürülecek koordinat: lat,lng. |
| mgrs | string | İ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.
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 kapsamJSON 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.
{
"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.
{
"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.
/api/1/countryParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| code | string | İsteğe bağlı | AZ | ISO 3166 alpha-2 veya alpha-3 ülke kodu (örn. AZ veya AZE). |
| name | string | İ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.
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 kapsamJSON 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.
{
"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.
{
"error": "Provide code=ISO2/ISO3 or name=CountryName."
}Geçerli ülke kodunu veya tam ülke adını kullanın.
{
"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.
/api/1/isochroneParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| point | string | Zorunlu | - | Merkez nokta. Biçim: lat,lon. |
| time_limit | integer | İsteğe bağlı | 600 | Seyahat 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.
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 kapsamJSON 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.
{
"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.
{
"error": "point parameter is required"
}Planın karmaşıklık limitlerini ve anahtar kısıtlarını kontrol edin.
{
"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.
{
"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.
{
"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.
/api/1/vrpParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| vehicles | array | İsteğe bağlı | one default vehicle | Araç listesi — her biri id, isteğe bağlı kapasite ve [lon, lat] dizisi (önce boylam) olarak bir başlangıç konumu içerir. |
| services | array | İ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. |
| shipments | array | İ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ı. |
| profile | string | İsteğe bağlı | driving | Ortak 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.
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 kapsamJSON 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.
{
"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.
{
"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.
{
"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.
{
"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).
/api/1/clusterParametreler (Query Params)
| Parametre | Tür | Durum | Varsayılan | Açıklama |
|---|---|---|---|---|
| customers | array | Zorunlu | [] | 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.
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 kapsamJSON 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.
{
"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.
{
"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.
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/infoEski 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.
GET /api/1/matrix?point=40.3755,49.8516&point=40.3892,49.8378{"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.
{"points":[[49.8516,40.3755],[49.8378,40.3892]],"timestamps":[1760000000,1760000120],"radiuses":[20,20]}{"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.
POST /api/1/optimize·POST /api/1/vrp/optimize→ Route Optimization APIPOST /api/1/cluster/calculate→ Location Clustering APIPOST /api/1/batch-geocode→ Batch Geocoding API
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.