Mimari

Arkada ne var?

Ham routing motorlarını müşteriye açmıyoruz. Tek güvenli kapı: api.barlasmaps.com

Sizin uygulamanız
Belediye / Kurye / Mobil

→

Kong Gateway
TLS + API key

→

BarlasMaps BFF
REST API

→

Valhalla

OSRM

Photon

Routing motorları yalnızca iç ağda çalışır — dış dünyaya port açılmaz.

API endpoint'leri

POST /v1/route

A→B rota, polyline, ETA ve manevra listesi. Valhalla birincil, OSRM yedek.

POST /v1/route/alternatives

2–3 alternatif rota. Ücretli/ücretsiz otoyol bilgisi.

POST /v1/map-match

GPS izini rotaya hizalama. Filo takibi ve navigasyon için.

GET /v1/geocode

Adres ve POI arama. Türkiye odaklı sonuç sıralaması.

GET /v1/chargers

Bbox ile şarj istasyonu sorgusu. 24.000+ kayıt.

GET /v1/radars

Bbox ile sabit radar noktaları.

Örnek entegrasyon

Herhangi bir dilde HTTP istemcisi yeterli.

curl örneği

curl -X POST https://api.barlasmaps.com/v1/route \
  -H "Content-Type: application/json" \
  -H "x-api-key: SIZIN_ANAHTARINIZ" \
  -d '{
    "origin": {"lat": 41.01, "lng": 28.97},
    "destination": {"lat": 39.93, "lng": 32.86}
  }'

Canlı Swagger'ı Aç

Güvenlik

🔑

API anahtarı

Her müşteriye benzersiz x-api-key. Kong gateway'de doğrulanır.

🛡️

Rate limiting

Pakete göre dakikalık istek limiti. DDoS ve kötüye kullanım koruması.

🔒

TLS / HTTPS

Tüm trafik şifreli. Let's Encrypt sertifikası.