WATAD Maps / الدليل

دليل المطورين

خريطة العراق في تطبيقك

خرائط وتد تعطيك خريطة العراق بستايل جاهز بالعربي والكوردي والإنگليزي، وبحثاً عن الأماكن والشوارع، وعنوان أي نقطة، والأماكن القريبة، والطريق بين نقطتين. كل شيء من رابط واحد ومفتاح مجاني، ويعمل على الويب وFlutter وAndroid وiOS وReact Native.

Base URL https://watadnexus.com/api/maps/v1

يعمل مع

اختر منصتك مرة واحدة، وكل الأمثلة في الدليل تفتح عليها.

المفاتيح

كل نداء يحتاج مفتاحاً. خذه مجاناً من صفحة المفاتيح بحساب وتد، ويبدأ بـ wm_.

أرسله بإحدى طريقتين:

• في الترويسة X-Watad-Key (الأفضل لنداءات البحث والعناوين).
• أو في الرابط ?key=، وهكذا يمرّ في رابط الستايل فتأخذه قطع الخريطة تلقائياً.

المكتبات

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

• أضف مستودع وتد في settings.gradle.kts maven("https://watadnexus.com/maps/sdk/android")
• أضف المكتبة في app/build.gradle.kts implementation("com.watadnexus:watad-maps:1.0.0")
• اعرض الخريطة WatadMapView(this, key = "YOUR_KEY")
• أضف MapLibre من Swift Package Manager github.com/maplibre/maplibre-gl-native-distribution
• نزّل WatadMapView.swift وضعه في مشروعك
• اعرض الخريطة WatadMapView(frame: .zero, key: "YOUR_KEY")
• أضف الحزمة flutter pub add watad_maps
• استوردها import 'package:watad_maps/watad_maps.dart';
• اعرض الخريطة WatadMap(watadKey: 'YOUR_KEY')
• ثبّت MapLibre npm install @maplibre/maplibre-react-native
• نزّل WatadMapView.tsx إلى مشروعك
• اعرض الخريطة <WatadMapView watadKey="YOUR_KEY" />
• استوردها من رابطها import { WatadMaps } from '…/watad-maps.mjs'
• اعرض الخريطة WatadMaps.create({ container: 'map', key: 'YOUR_KEY' })
• حمّلها داخل useEffect import(/* @vite-ignore */ SDK)
• اعرض الخريطة في div WatadMaps.create({ container: box.current, key })

التثبيت

لكل منصة مكتبة من وتد مبنية على MapLibre، المكتبة المفتوحة لرسم الخرائط: الويب وReact وReact Native وFlutter وAndroid وiOS. الخريطة تفتح من خلالها، والخدمات (البحث والعناوين والطرق) JSON عادي تناديه من أي كود.

أول خريطة

ضع مفتاحك مكان YOUR_KEY. الخريطة تفتح على بغداد بالعربي وبأيقونات وتد.

• العراق وحده: الدول المجاورة مغطاة في الستايل نفسه، فلا تظهر أبداً.
• ستايل وتد وأيقوناته الـ153 ودبوسه، بلا أي إعداد.
• الكاميرا تبقى على العراق (سطران في الأمثلة، وتقدر تشيلهم).

مكتبة وتد للويب

سطر استيراد واحد ومفتاحك، وتأتي الخريطة بكل شيء من عندنا: العراق وحده، الستايل والأيقونات، الدبوس، البحث والعناوين والاتجاهات. مبنية على MapLibre، فكل ما تقدر عليه MapLibre تقدر عليه هنا عبر wm.map.

الخيارات

ما تقدر تفعله

اللغات والوضع الداكن

الستايل واحد، وتختار لغته وشكله من الرابط:

لتبديل اللغة أو الوضع أثناء التشغيل حمّل الستايل من جديد بالرابط الجديد (مثلاً map.setStyle(url) على الويب).

دبوس وتد

دبوسنا وتد مغروز في المكان: رأس معيّن أزرق ينفتح على أيقونة المكان واسمه. على الويب يأتي بحركته كاملة مع مكتبتنا، وفي التطبيقات يأتي جاهزاً في الستايل: مصدر اسمه watad-pin تملؤه بنقاط فيها name.

ما في الخريطة

• العراق وحده: ما خارج الحدود يُطفأ، والحدود مرسومة بخط واضح.
• الطرق والشوارع والأنهار والمباني من OpenStreetMap، حتى المستوى 15 (وتكبّر بعده).
• طبقة أماكن وتد pois بـ 153 نوعاً ولكل نوع أيقونته، تظهر من بعيد بلا ازدحام.

لمعرفة المكان الذي ضغط عليه المستخدم في الخريطة اقرأ خصائصه من طبقة pois، ثم اجلب تفاصيله بمعرّفه:

البحث والإكمال التلقائي

يبحث في كل الأماكن والشوارع والمناطق من أول حرفين، ويفهم الكلمة كما يكتبها الناس: بالهمزة أو بدونها، بالتاء المربوطة أو الهاء، بالعربي أو الكوردي أو الإنگليزي. واسم النوع وحده ("صيدلية"، "بنزينخانة"، "سيطرة") يجيب الأقرب إلى near.

عنوان نقطة

أعطه نقطة يعطك ما فيها: أقرب مكان، الشارع، الحي، المدينة، المحافظة، وسطر عنوان جاهز للعرض. هذا قلب تطبيقات التكسي والتوصيل.

الأماكن القريبة

الأقرب حول نقطة، الأقرب أولاً. بلا cat تأتي كل الأنواع.

نوع واحد فقط على الخريطة

لما يختار المستخدم «مستشفيات» مثلاً، اعرضها وحدها بأيقوناتنا وأخفِ باقي الأماكن، فلا تتراكم العلامات فوق بعضها. الستايل فيه طبقة جاهزة لهذا: watad-results، وطبقة أماكن الخريطة اسمها pois.

مكان بمعرّفه

كل مكان له معرّف ثابت (مثل n12541597157). احفظه في قاعدة بياناتك واجلب المكان به متى شئت، مع هاتفه وموقعه وساعات عمله إن وُجدت.

الاتجاهات

الطريق بين نقطتين بالسيارة أو مشياً: المسافة بالكيلومتر، الوقت بالدقائق، الخط لترسمه على الخريطة، وخطوات الانعطاف. بالسيارة قد تأتي حتى ثلاثة طرق، الأفضل أولاً.

تطبيق تكسي

أكثر طريقة مريحة لاختيار نقطة الالتقاط: دبوس ثابت في وسط الشاشة، والمستخدم يحرّك الخريطة تحته، ومتى توقفت الخريطة يظهر العنوان. نداء واحد للعنوان في كل توقف.

• الخريطة ودبوس في الوسط الدبوس صورة فوق الخريطة وليس علامة عليها، فلا يتحرك.
• العنوان عند التوقف اسأل /reverse عن وسط الخريطة عند moveend أو onCameraIdle.
• الوجهة بحث بالإكمال التلقائي، ثم /route للمسافة والوقت والسعر التقريبي.

تطبيق توصيل

• عنوان الزبون نفس دبوس التكسي: الزبون يضع الدبوس على بيته، وأنت تحفظ lat وlon مع سطر العنوان من /reverse، ويضيف هو تفاصيل البيت كتابةً.
• أقرب فرع احسب أقرب فرع لك بنفسك، أو إن كانت فروعك على الخريطة استعمل /nearby.
• الطريق والوقت /route من الفرع إلى الزبون يعطي وقت الوصول المتوقع.
• السائق على الخريطة موقع السائق يصل من سيرفرك وتحرّكه على الخريطة (القسم التالي).

تتبع السائق مباشرة

تطبيق السائق يرسل موقعه إلى سيرفرك كل بضع ثوانٍ، وسيرفرك يمرّره إلى الزبون (WebSocket أو Firebase أو ما تستعمله). على الخريطة نقطة واحدة تحرّكها، بلا أي نداء لنا.

كل النداءات

كلها GET، وتجيب JSON بـ UTF-8، وتقبل المفتاح في X-Watad-Key أو ?key=، وتسمح بالنداء من أي موقع (CORS).

شكل المكان

أنواع الأماكن

153 نوعاً، لكل واحد أيقونة. استعمل المعرّف في cat.

• hospital مستشفى
• dentist طبيب أسنان
• pharmacy صيدلية
• lab مختبر
• vet طبيب بيطري
• university جامعة
• library مكتبة عامة
• restaurant مطعم
• fastfood وجبات سريعة
• cafe مقهى
• bakery مخبز
• bank مصرف
• atm صراف آلي
• exchange صيرفة
• fuel محطة وقود
• carwash غسل سيارات
• carrepair تصليح سيارات
• cars معرض سيارات
• parking موقف سيارات
• bus محطة باص
• train محطة قطار
• airport مطار
• market سوق
• mall مول
• supermarket سوبرماركت
• grocery بقالة وخضار
• clothes ملابس
• phones موبايلات
• jewelry مجوهرات
• beauty حلاق وصالون
• furniture أثاث
• hardware عدد وأدوات
• books مكتبة وقرطاسية
• shop محل
• mosque جامع
• church كنيسة
• worship دار عبادة
• police شرطة
• fire دفاع مدني
• government دائرة حكومية
• post بريد
• embassy سفارة
• community مركز مجتمعي
• hotel فندق
• cinema سينما ومسرح
• museum متحف
• heritage موقع أثري
• attraction معلم سياحي
• viewpoint إطلالة
• park حديقة
• stadium ملعب
• peak قمة جبل
• water عين ماء
• doctor طبيب
• clinic عيادة ومجمع طبي
• optician نظارات وبصريات
• nursing دار رعاية
• kindergarten روضة أطفال
• school مدرسة
• college كلية ومعهد
• institute مركز تعليمي
• driving تعليم سياقة
• language تعليم لغات
• music موسيقى
• icecream آيس كريم
• sweets حلويات
• cake كيك ومعجنات
• internetcafe مقهى إنترنت
• fish أسماك
• butcher قصاب
• greengrocer خضار وفواكه
• drinks مشروبات وعصائر
• payment نقطة دفع
• transfer حوالات مالية
• insurance تأمين
• charging شحن سيارات كهربائية
• tyres إطارات
• carparts أدوات احتياطية
• carrental تأجير سيارات
• motorcycle دراجات نارية
• bicycle دراجات هوائية
• taxi تكسي
• bridge جسر
• travel سفر وسياحة
• ticket حجز تذاكر
• department متجر متعدد الأقسام
• variety منوعات وجملة
• shoes أحذية
• tailor خياط وأقمشة
• sportshop مستلزمات رياضية
• gift هدايا
• florist ورد
• toys لعب أطفال
• pets طيور وحيوانات أليفة
• laundry مصبغة
• electrical كهربائيات
• kitchen أدوات منزلية
• appliance أجهزة منزلية
• electronics إلكترونيات
• computer حاسبات
• games ألعاب فيديو
• photo تصوير
• print استنساخ وطباعة
• cosmetics مكياج وعناية
• perfume عطور
• watch ساعات
• carpet سجاد وديكور
• paint أصباغ
• stationery قرطاسية
• gas غاز
• plants مشاتل ونباتات
• baby مستلزمات أطفال
• court محكمة
• lawyer محاماة
• office شركة ومكتب
• telecom اتصالات وإنترنت
• realestate مكتب عقار
• ngo منظمة
• checkpoint سيطرة
• events قاعة مناسبات
• shrine مرقد ومزار
• cemetery مقبرة
• apartment شقق ومجمعات سكنية
• camp مخيم
• chalet شاليهات ومنتجعات
• theatre مسرح
• artwork عمل فني
• monument نصب
• castle قلعة
• gate بوابة تاريخية
• info معلومات سياحية
• cave كهف
• garden حديقة صغيرة
• playground ساحة ألعاب
• zoo حديقة حيوانات
• funpark مدينة ألعاب
• gym نادي لياقة
• sports مركز رياضي
• pool مسبح
• pitch ساحة رياضية
• valley وادي
• picnic مكان تنزه
• farm مزرعة وحقل
• hotspring عين كبريتية حارة
• waterfall شلال
• lake بحيرة
• dam سد
• drinkingwater ماء شرب
• fountain نافورة
• waterworks مشروع ماء
• industrial منطقة صناعية ومعمل
• oil حقل نفط
• power محطة كهرباء

المجموعات: health · food · shop · money · move · learn · faith · civic · stay · culture · green · water · work

المحافظات

استعمل المعرّف في gov لحصر البحث بمحافظة.

الأخطاء

الخطأ يأتي برمز HTTP وجسم مثل:

الحدود

الاستهلاك اليومي لكل مفتاح تراه في صفحة المفاتيح. تطبيقك أكبر من هذا؟ راسلنا ونرفع حدّك.

الإشارة للمصدر

بيانات الخريطة من مساهمي OpenStreetMap (رخصة ODbL). أبقِ © OpenStreetMap · WATAD Maps ظاهرة على الخريطة؛ مكتبات وتد تضعها في زاوية الخريطة بنفسها، ولا يمكن إزالتها.

المفاتيح الجديدة تفتح الخريطة (الستايل والمربعات) من خلال مكتبات وتد فقط. الخدمات بلا خريطة، مثل البحث والعناوين والطرق، تبقى مفتوحة لأي كود ومن خادمك.