العودة لبوابة المطورينخدمة الخرائطv1 مخطط لها

توثيق واجهة برمجة خدمة الخرائط

مرجع موحّد للمسارات والمصفوفة والبحث والإكمال التلقائي والعكس الجغرافي والأماكن القريبة وتفاصيل المكان ومطابقة المسار عبر api.omysyria.com.

مفتاح موحد لخدمة الخرائط

أنشئ مفتاحاً خاصاً بالمؤسسة من لوحة تحكم خدمة الخرائط. يظهر المفتاح الكامل مرة واحدة، ويعمل مع كل عملية مفعّلة ضمن المؤسسة نفسها.

حدود الأمان

أرسل المفتاح في X-API-Key أو Bearer من خادمك فقط. لا تضعه في المتصفح أو تطبيق الموبايل أو URL أو السجلات. الحصص التجارية لكل خدمة ما تزال مخططة لاحقاً.

مرجع API الإصدار v1

العقود الثمانية الموحّدة

تظل العمليات بحالة مخططة حتى اكتمال تفعيلها المصرّح به في البيئة المستضافة. الأمثلة أدناه هي العقود العامة الرسمية.

POST /v1/directionsمخطط لها

مثال الطلب

curl -X POST 'https://api.omysyria.com/v1/directions'
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{"origin":{"lat":33.5138,"lng":36.2765},"destination":{"lat":33.5102,"lng":36.2913},"preference":"fastest","costing":"auto"}'

شكل الاستجابة

{
  "summary": {
    "distance": {
      "meters": 3900,
      "kilometers": 3.9
    },
    "duration": {
      "seconds": 720,
      "minutes": 12
    }
  },
  "geometry": "polyline6…"
}

الاستجابات الآمنة المشتركة

HTTPCodeالمعنى
401maps_api_key_requiredمفتاح العميل مفقود.
403maps_api_key_invalidالمفتاح غير صالح أو غير نشط.
422invalid_inputالمدخلات لا تطابق العقد المحدود.
429rate_limit_exceededتم بلوغ حد الطلبات الحالي.
503maps_unavailableالعملية معطلة أو الاعتمادية غير متاحة.