خدمة تحديد طريقة الخرائط الداخلية (معاينة)

تتيح لك خدمة خرائط Azure Creator wayfinding إمكانية التنقل من مكان إلى آخر في أي مكان داخل الخريطة الداخلية. تستخدم الخدمة السلالم والمصاعد للتنقل بين الطوابق وتوفر إرشادات لمساعدتك في التنقل حول العوائق المادية. توضح هذه المقالة كيفية إنشاء مسار من نقطة بداية إلى نقطة وجهة في عينة خريطة داخلية.

المتطلبات الأساسية

• فهم مفاهيم المنشئ.
• مجموعة بيانات خرائط Azure Creator ومجموعة الإطارات المتجانبة. إذا لم يسبق لك استخدام خرائط Azure Creator لإنشاء خريطة داخلية، فقد تجد البرنامج التعليمي استخدام المنشئ لإنشاء خرائط داخلية مفيدا.

هام

• تستخدم هذه المقالة عنوان URL الجغرافي us.atlas.microsoft.com. إذا لم يتم إنشاء مؤلف خدمتك داخل الولايات المتحدة، فعليك استخدام عنوان URL مختلف جغرافياً. لمزيد من المعلومات، راجع الوصول إلى خدمات المنشئ.
• في أمثلة URL في هذه المقالة، ستحتاج إلى:
  • استبدل {Your-Azure-Maps-Subscription-key} بمفتاح اشتراك خرائط Azure.
  • استبدل {datasetId} ب datasetId. لمزيد من المعلومات، راجع قسم التحقق من حالة إنشاء مجموعة البيانات في البرنامج التعليمي استخدام المنشئ لإنشاء خرائط داخلية.

إنشاء مجموعة مسارات

مجموعة التوجيه هي مجموعة من بيانات الخريطة الداخلية التي تستخدمها خدمة تحديد الطريق.

يتم إنشاء مجموعة توجيه من مجموعة بيانات. مجموعة التوجيه مستقلة عن مجموعة البيانات، ما يعني أنه إذا تم حذف مجموعة البيانات، تستمر مجموعة التوجيه في الوجود.

بمجرد إنشاء مجموعة مسارات، يمكنك بعد ذلك استخدام واجهة برمجة التطبيقات الخاصة ب wayfinding للحصول على مسار من نقطة البداية إلى نقطة الوجهة داخل المرفق.

لإنشاء مجموعة توجيه:

1. تنفيذ طلب HTTP POST التالي:

   https://us.atlas.microsoft.com/routesets?api-version=2023-03-01-preview&datasetID={datasetId}&subscription-key={Your-Azure-Maps-Subscription-key} 
   
   

2. انسخ قيمة مفتاح Operation-Location من عنوان الاستجابة.

مفتاح Operation-Location هو عنوان URL للحالة المستخدم للتحقق من حالة إنشاء مجموعة التوجيه كما هو موضح في القسم التالي.

تحقق من حالة إنشاء مجموعة التوجيه واسترداد routesetId

للتحقق من حالة عملية إنشاء مجموعة التوجيه واسترداد routesetId:

1. تنفيذ طلب HTTP GET التالي:

   https://us.atlas.microsoft.com/routesets/operations/{operationId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key} 
   
   

   إشعار

   احصل على operationId من مفتاح Operation-Location في عنوان الاستجابة عند إنشاء مجموعة توجيه جديدة.

2. انسخ قيمة مفتاح Resource-Location من عنوان الاستجابات. إنه عنوان URL لموقع المورد ويحتوي على routesetId:

   https://us.atlas.microsoft.com/routesets/**675ce646-f405-03be-302e-0d22bcfe17e8**?api-version=2023-03-01-preview

دَون routesetId القيمة. وهو مطلوب في جميع طلبات التعريف وعند الحصول على معرف المرفق.

الحصول على معرف المرفق

تعد facilityIdالخاصية ، وهي خاصية لمجموعة التوجيه، معلمة مطلوبة عند البحث عن مسار معرف. احصل على facilityId عن طريق الاستعلام عن مجموعة التوجيه.

1. تنفيذ طلب HTTP GET التالي:

   https://us.atlas.microsoft.com/routesets/{routesetId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key} 
   
   

2. facilityId هي خاصية للكائنfacilityDetails، والتي يمكنك العثور عليها في نص الاستجابة لطلب مجموعة التوجيه، وهو FCL43 في المثال التالي:

{
    "routeSetId": "675ce646-f405-03be-302e-0d22bcfe17e8",
    "dataSetId": "eec3825c-620f-13e1-b469-85d2767c8a41",
    "created": "10/10/2022 6:58:32 PM +00:00",
    "facilityDetails": [
        {
            "facilityId": "FCL43",
            "levelOrdinals": [
                0,
                1
            ]
        }
    ],
    "creationMode": "Wall",
    "ontology": "facility-2.0"
}

الحصول على مسار معرف الطريق

استخدم واجهة برمجة تطبيقات تحديد الطريق لإنشاء مسار من مجموعة التوجيه التي قمت بإنشائها في القسم السابق. تتطلب واجهة برمجة التطبيقات التي تم تعريفها استعلاما يحتوي على نقاط البداية والنهاية في خريطة داخلية، إلى جانب أرقام ترتيبية على مستوى الأرضية. لمزيد من المعلومات حول تعريف المنشئ، راجع طريقة التعريف في مقالة المفاهيم.

لإنشاء استعلام تعريف الطريق:

1. نفذ طلب HTTP GET التالي (استبدل {routesetId} ب routesetId الذي تم الحصول عليه في قسم التحقق من حالة إنشاء مجموعة التوجيه و{facilityId} بمعرف المرفق الذي تم الحصول عليه في قسم الحصول على معرف المرفق):

   https://us.atlas.microsoft.com/wayfinding/path?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}&routesetid={routeset-ID}&facilityid={facility-ID}&fromPoint={lat,lon}&fromLevel={from-level}&toPoint={lat,lon}&toLevel={to-level}&minWidth={minimun-width}
   

   تلميح

   AvoidFeatures يمكن استخدام المعلمة لتحديد شيء ما لخدمة تحديد الطريق لتجنبه عند تحديد المسار، مثل المصاعد أو السلالم.

2. يتم عرض تفاصيل المسار والساقين في نص الاستجابة.

يعرض الملخص وقت السفر المقدر بالثوان لإجمالي الرحلة. بالإضافة إلى ذلك، يتم عرض الوقت المقدر لكل قسم من الرحلة في بداية كل ساق.

تحسب خدمة تحديد الطريق المسار من خلال نقاط تدخل محددة. يتم عرض كل نقطة، جنبا إلى جنب مع تفاصيل خط الطول والعرض.