مسار MASAR · DOCS

خرائط العراق عبر API

البحث بالاسم، والعنوان من الإحداثيات، والمسار بالسيارة مع الزحمة، ومصفوفة المسافات، وأقرب طريق، وترتيب التوقفات، والطرق المغلقة، وخريطة بأسماء عربية. مبنية على OpenStreetMap ومستضافة على خوادمنا، بواجهات Photon وOSRM الأصلية.

ابدأ من هنا افتح الملعب
العناوين الأساسية
GEOCODER_URL = https://<الخادم>/geocoder
ROUTING_URL  = https://<الخادم>/routing
TILES_URL    = https://<الخادم>/tiles

جرّب البحث الآن

ضع مفتاحك في الأعلى، ثم ابحث. «مدينه الصدر» بالهاء تجد «مدينة الصدر»، والنتائج تُرسم على الخريطة.

جرّب الآن

GET /geocoder/api
الطلب كـ curl 


    

        
اضغط على الخريطة لترتيب النتائج حول تلك النقطة (lat/lon).


    

        
الرد كاملاً 
            


    
الخدمات

        
كل خط مجموعة خدمات، وكل محطة صفحة فيها الشرح والمعاملات وتجربة مباشرة على الخريطة.

        
البحث

                    
  1. البحث بالاسم
                                    إكمال تلقائي لأسماء الأماكن والشوارع في العراق بالعربي والإنجليزي. يجد التهجئة التي لم يكتبها المستخدم («مدينه» تجد «مدينة»)، وأماكن عميلك الخاصة أولاً.
                                    GET
    /geocoder/api
  2. العنوان من الإحداثيات
                                    أقرب الأماكن والعنوان لنقطة: لعرض عنوان الدبوس الذي وضعه المستخدم.
                                    GET
    /geocoder/reverse
  3. روابط Google Maps المختصرة
                                    يحوّل رابطاً مختصراً لصقه المستخدم (maps.app.goo.gl) إلى الرابط الكامل الذي فيه الإحداثيات.
                                    GET
    /geocoder/links/v1/resolve
المسار

                    
  1. المسار
                                    مسار بالسيارة عبر 2–25 نقطة بالترتيب، مع الزمن والمسافة، ومستوى الزحمة عند الطلب.
                                    GET
    /routing/route/v1/driving/{coordinates}
  2. مصفوفة الأزمنة والمسافات
                                    الزمن والمسافة من كل نقطة بداية إلى كل نقطة وصول في طلب واحد: لإيجاد أقرب سائق لزبون.
                                    GET
    /routing/table/v1/driving/{coordinates}
  3. أقرب طريق
                                    ينقل نقطة إلى أقرب طريق صالح للسيارات: لوضع دبوس الاستلام على الشارع.
                                    GET
    /routing/nearest/v1/driving/{coordinates}
  4. أسرع ترتيب للتوقفات
                                    يرتّب 2–25 توقفاً في أسرع رحلة: جولة توصيل من المستودع إلى آخر زبون.
                                    GET
    /routing/trip/v1/driving/{coordinates}
الزحمة

                    
  1. إرسال مسار GPS (الزحمة)
                                    تطبيقات السائقين ترسل نقاط GPS لمركبة واحدة؛ تُحفظ سرعة كل جزء طريق فقط فتتحسن أزمنة الوصول للجميع.
                                    POST
    /routing/traffic/v1/traces
  2. الطرق المغلقة
                                    الطرق التي أغلقها فريق العمليات (سيطرات، أعمال، مناسبات) كطبقة GeoJSON لعرضها على الخريطة. حساب المسار يتجنبها أصلاً.
                                    GET
    /routing/closures/v1
الخريطة

                    
  1. الخريطة (vector tiles)
                                    خريطة العراق من نفس الخادم بأسماء عربية، لـ MapLibre (ويب، Android، iOS، Flutter). اختيارية: قد لا تكون مفعّلة على كل خادم.
                                    GET
    /tiles/style.json


    
في ثلاث خطوات

            
  1. احصل على مفتاح من فريق مسار، أو من «مفاتيح API» في بوابة العملاء، بالخدمات التي يحتاجها تطبيقك.
    2. 
                
  2. أرسله في الترويسة X-Api-Key من الموبايل أو الخادم. مواقع الويب تستطيع بدلاً منه تسجيل نطاقها.
    3. 
                
  3. انتبه للإحداثيات: المسار يأخذ lng,lat (خط الطول أولاً)، والبحث يأخذ lat= وlon=.

        
أول طلب
curl -H "X-Api-Key: $KEY" \
  "https://<الخادم>/routing/route/v1/driving/44.3661,33.3152;44.4009,33.2778?overview=false&congestion=true"