إظهار الاتجاهات من A إلى B
توضح لك هذه المقالة كيفية تقديم طلب مسار وإظهار المسار على الخريطة.
هناك طريقتان للقيام بذلك. الطريقة الأولى هي الاستعلام عن واجهة برمجة تطبيقات مسار خرائط Azure من خلال وحدة خدمة. الطريقة الثانية هي استخدام واجهة برمجة تطبيقات الجلب لتقديم طلب بحث إلى واجهة برمجة تطبيقات مسار خرائط Azure. وتناقش كلتا الطريقتين أدناه.
الاستعلام عن المسار عبر وحدة الخدمة
في التعليمة البرمجية أعلاه، تقوم الكتلة الأولى بإنشاء كائن خريطة وتعيين آلية المصادقة لاستخدام رمز الوصول. يمكنك رؤية إنشاء خريطة للحصول على التعليمات.
تقوم الكتلة الثانية من التعليمات البرمجية بإنشاء مصادقة TokenCredential طلبات HTTP خرائط Azure باستخدام رمز الوصول. ثم يمرر TokenCredential إلى atlas.service.MapsURL.newPipeline() وإنشاء مثيل خط الأنابيب . يمثل routeURL عنوان URL لعمليات مسارات Microsoft Azure Maps .
تقوم الكتلة الثالثة من التعليمات البرمجية بإنشاء كائن DataSource وإضافته إلى الخريطة.
تقوم الكتلة الرابعة من التعليمات البرمجية بإنشاء كائنات نقاط البداية والنهاية وإضافتها إلى كائن dataSource.
الخط هو ميزة ل lineString. تقوم طبقة الخط بعرض كائنات الخط ملفوفة في DataSource كخطوط على الخريطة. تقوم الكتلة الرابعة من التعليمات البرمجية بإنشاء طبقة سطر وإضافتها إلى الخريطة. راجع خصائص طبقة خط في LinestringLayerOptions.
تستخدم طبقة الرموز نصوصا أو أيقونات لعرض البيانات المستندة إلى نقطة ملفوفة في DataSource. يتم عرض النصوص أو الرموز كرموز على الخريطة. تقوم الكتلة الخامسة من التعليمات البرمجية بإنشاء طبقة رمز وإضافتها إلى الخريطة.
تستفسر الكتلة السادسة من التعليمات البرمجية عن خدمة توجيه خرائط Azure ، والتي تعد جزءا من وحدة الخدمة. يتم استخدام طريقة حساب RouteDirections الخاصة ب RouteURL للحصول على مسار بين نقطتي البداية والنهاية. ثم يتم استخراج مجموعة معالم GeoJSON من الاستجابة باستخدام geojson.getFeatures() الطريقة وتتم إضافتها إلى مصدر البيانات. ثم يعرض الاستجابة كمسار على الخريطة. لمزيد من المعلومات حول إضافة خط إلى الخريطة، راجع إضافة سطر على الخريطة.
تقوم الكتلة الأخيرة من التعليمات البرمجية بتعيين حدود الخريطة باستخدام خاصية setCamera الخاصة بالخريطة.
يتم إنشاء استعلام المسار ومصدر البيانات والرمز وطبقات الخطوط وحدود الكاميرا داخل مستمع الحدث. تضمن بنية التعليمات البرمجية هذه عرض النتائج فقط بعد تحميل الخريطة بالكامل.
الاستعلام عن المسار عبر واجهة برمجة تطبيقات الجلب
في التعليمات البرمجية أعلاه، تقوم الكتلة الأولى من التعليمات البرمجية بإنشاء كائن خريطة وتعيين آلية المصادقة لاستخدام رمز الوصول. يمكنك رؤية إنشاء خريطة للحصول على التعليمات.
تقوم الكتلة الثانية من التعليمات البرمجية بإنشاء كائن DataSource وإضافته إلى الخريطة.
تقوم كتلة التعليمات البرمجية الثالثة بإنشاء نقاط البداية والوجهة للمسار. بعد ذلك ، يضيفها إلى مصدر البيانات. يمكنك رؤية إضافة دبوس على الخريطة للحصول على إرشادات حول استخدام addPins.
تقوم طبقة الخط بعرض كائنات الخط ملفوفة في DataSource كخطوط على الخريطة. تقوم الكتلة الرابعة من التعليمات البرمجية بإنشاء طبقة سطر وإضافتها إلى الخريطة. راجع خصائص طبقة خط في LineLayerOptions.
تستخدم طبقة الرموز نصا أو أيقونات لعرض البيانات المستندة إلى نقطة ملفوفة في DataSource كرموز على الخريطة. تقوم الكتلة الخامسة من التعليمات البرمجية بإنشاء طبقة رمز وإضافتها إلى الخريطة. راجع خصائص طبقة الرمز في SymbolLayerOptions.
تقوم كتلة التعليمات البرمجية التالية بإنشاء SouthWest نقاط البداية والوجهة والإشارة NorthEast إليها وتعيين حدود الخريطة باستخدام خاصية setCamera الخاصة بالخريطة.
تستخدم الكتلة الأخيرة من التعليمات البرمجية واجهة برمجة تطبيقات الجلب لتقديم طلب بحث إلى واجهة برمجة تطبيقات مسار خرائط Azure. ثم يتم تحليل الاستجابة. إذا كانت الاستجابة ناجحة، يتم استخدام معلومات خطوط الطول والعرض لإنشاء صفيف خط عن طريق توصيل تلك النقاط. ثم تتم إضافة بيانات الخط إلى مصدر البيانات لعرض المسار على الخريطة. يمكنك رؤية إضافة سطر على الخريطة للحصول على التعليمات .
يتم إنشاء استعلام المسار ومصدر البيانات والرمز وطبقات الخطوط وحدود الكاميرا داخل مستمع الحدث. مرة أخرى ، نريد التأكد من عرض النتائج بعد تحميل الخريطة بالكامل.
الخطوات التالية
تعرف على المزيد حول الفئات والأساليب المستخدمة في هذه المقالة:
راجع المقالات التالية للحصول على أمثلة التعليمات البرمجية الكاملة: