توثيق واجهة برمجة خدمة الخرائط
مرجع موحّد للمسارات والمصفوفة والبحث والإكمال التلقائي والعكس الجغرافي والأماكن القريبة وتفاصيل المكان ومطابقة المسار عبر 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…"
}الاستجابات الآمنة المشتركة
| HTTP | Code | المعنى |
|---|---|---|
| 401 | maps_api_key_required | مفتاح العميل مفقود. |
| 403 | maps_api_key_invalid | المفتاح غير صالح أو غير نشط. |
| 422 | invalid_input | المدخلات لا تطابق العقد المحدود. |
| 429 | rate_limit_exceeded | تم بلوغ حد الطلبات الحالي. |
| 503 | maps_unavailable | العملية معطلة أو الاعتمادية غير متاحة. |