عرض نتائج البحث على الخريطة
توضح لك هذه المقالة كيفية البحث عن موقع الاهتمام وعرض نتائج البحث على الخريطة.
هناك طريقتان للبحث عن موقع مثير للاهتمام. إحدى الطرق هي استخدام وحدة خدمة لتقديم طلب بحث. الطريقة الأخرى هي تقديم طلب بحث خرائط Azure واجهة برمجة تطبيقات البحث الضبابية من خلال واجهة برمجة تطبيقات Fetch. وتناقش كلتا الطريقتين أدناه.
تقديم طلب بحث عبر وحدة الخدمة
في التعليمات البرمجية أعلاه ، تقوم الكتلة الأولى بإنشاء كائن خريطة وتعيين آلية المصادقة لاستخدام رمز الوصول. يمكنك رؤية إنشاء خريطة للحصول على التعليمات.
تقوم الكتلة الثانية من التعليمات البرمجية بإنشاء مصادقة TokenCredential طلبات HTTP خرائط Azure باستخدام رمز الوصول. ثم يمرر TokenCredential إلى atlas.service.MapsURL.newPipeline() وإنشاء مثيل خط الأنابيب . يمثلsearchURLعنوان URL لعمليات Search خرائط Azure.
تقوم الكتلة الثالثة من التعليمات البرمجية بإنشاء كائن مصدر بيانات باستخدام فئة DataSource وإضافة نتائج بحث إليها. تستخدم طبقة الرموز نصا أو أيقونات لعرض البيانات المستندة إلى نقطة ملفوفة في DataSource كرموز على الخريطة. ثم يتم إنشاء طبقة رمز. تتم إضافة مصدر البيانات إلى طبقة الرمز، والتي تتم إضافتها بعد ذلك إلى الخريطة.
تستخدم كتلة التعليمات البرمجية الرابعة طريقة SearchFuzzy في وحدة الخدمة. يسمح لك بإجراء بحث نصي مجاني عن النموذج عبر واجهة برمجة تطبيقات Get Search Fuzzy rest للبحث عن نقطة الاهتمام. يمكن الحصول على طلبات إلى Search Fuzzy API التعامل مع أي مجموعة من المدخلات الضبابية. يتم بعد ذلك استخراج مجموعة معالم GeoJSON من الاستجابة باستخدام الطريقة geojson.getFeatures()وإضافتها إلى مصدر البيانات، مما يؤدي تلقائيًا إلى عرض البيانات على الخريطة عبر طبقة الرمز.
تقوم الكتلة الأخيرة من التعليمات البرمجية بضبط حدود الكاميرا للخريطة باستخدام خاصية setCamera الخاصة بالخريطة.
يوجد طلب البحث ومصدر البيانات وطبقة الرمز وحدود الكاميرا داخل مستمع الحدث للخريطة. نريد التأكد من عرض النتائج بعد تحميل الخريطة بالكامل.
تقديم طلب بحث عبر واجهة برمجة تطبيقات الجلب
في التعليمة البرمجية أعلاه، تقوم الكتلة الأولى من التعليمات البرمجية بإنشاء كائن خريطة. يقوم بتعيين آلية المصادقة لاستخدام رمز الوصول. يمكنك رؤية إنشاء خريطة للحصول على التعليمات.
تنشئ الكتلة الثانية من التعليمات البرمجية عنوان URL لتقديم طلب بحث إليه. كما أنه ينشئ صفيفين لتخزين الحدود والدبابيس لنتائج البحث.
تستخدم الكتلة الثالثة من التعليمات البرمجية واجهة برمجة تطبيقات Fetch. يتم استخدام واجهة برمجة تطبيقات الجلب لتقديم طلب خرائط Azure واجهة برمجة تطبيقات البحث الضبابية للبحث عن نقاط الاهتمام. يمكن لواجهة برمجة تطبيقات البحث الضبابي التعامل مع أي مجموعة من المدخلات الغامضة. ثم يعالج استجابة البحث ويوزعها ويضيف دبابيس النتائج إلى صفيف Search Pins.
تقوم الكتلة الرابعة من التعليمات البرمجية بإنشاء كائن مصدر بيانات باستخدام فئة DataSource . في التعليمات البرمجية ، نضيف نتائج البحث إلى الكائن المصدر. تستخدم طبقة الرموز نصا أو أيقونات لعرض البيانات المستندة إلى نقطة ملفوفة في DataSource كرموز على الخريطة. ثم يتم إنشاء طبقة رمز. تتم إضافة مصدر البيانات إلى طبقة الرمز، والتي تتم إضافتها بعد ذلك إلى الخريطة.
الكتلة الأخيرة من التعليمات البرمجية بإنشاء كائن BoundingBox . يستخدم مجموعة النتائج ، ثم يقوم بضبط حدود الكاميرا للخريطة باستخدام setCamera الخاص بالخريطة. ثم يجعل دبابيس النتيجة.
يتم تعيين طلب البحث ومصدر البيانات وطبقة الرمز وحدود الكاميرا داخل مستمع أحداث الخريطة لضمان عرض النتائج بعد تحميل الخريطة بالكامل.
الخطوات التالية
مزيد من المعلومات حول البحث الضبابي:
تعرف على المزيد حول الفئات والأساليب المستخدمة في هذه المقالة:
راجع المقالات التالية للحصول على أمثلة التعليمات البرمجية الكاملة: