مشاركة عبر

البرنامج التعليمي: استخدام خرائط Azure Creator لإنشاء خرائط داخلية

  • مقالة

يصف هذا البرنامج التعليمي كيفية إنشاء خرائط داخلية للاستخدام في خرائط Microsoft Azure. يوضح هذا البرنامج التعليمي كيفية:

  • قم بتحميل حزمة الرسم للخرائط الداخلية.
  • تحويل حزمة الرسم إلى بيانات الخريطة.
  • أنشئ مجموعة بيانات من البيانات الموجودة في خريطتك.
  • أنشئ tileset من البيانات الموجودة في قاعدة بياناتك.
  • احصل على معرف تكوين الخريطة الافتراضي من مجموعة الإطارات المتجانبة.

يمكنك أيضا إنشاء مجموعة بيانات من حزمة GeoJSON. لمزيد من المعلومات، راجع إنشاء مجموعة بيانات باستخدام حزمة GeoJSON (معاينة).

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

يستخدم هذا البرنامج التعليمي تطبيق ⁧⁩Postman⁧⁩؛ ولكن يمكنك استخدام بيئة تطوير API مختلفة.

هام

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

تحميل حزمة رسم

اتبع الخطوات الموضحة في مقالة كيفية إنشاء سجل البيانات لتحميل حزمة GeoJSON إلى حساب تخزين Azure الخاص بك ثم تسجيلها في حساب خرائط Azure الخاص بك.

هام

تأكد من تدوين قيمة المعرف الفريد (udid)، ستحتاج إليها. udid هي الطريقة التي تشير بها إلى حزمة GeoJSON التي قمت بتحميلها إلى حساب تخزين Azure الخاص بك من التعليمات البرمجية المصدر وطلبات HTTP.

تحويل حزمة رسم

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

لتحويل حزمة رسم:

  1. حدد New في تطبيق Postman.

  2. ومن نافذة إنشاء جديد حدد طلب HTTP.

  3. بالنسبة إلى اسم الطلب، أدخل اسما للطلب، مثل POST Convert Drawing Package.

  4. حدد أسلوبPOST HTTP.

  5. أدخل عنوان URL التالي في خدمة التحويل. استبدل {Your-Azure-Maps-Subscription-key} بمفتاح اشتراك خرائط Azure. udid استبدل udid بقيمة الحزمة التي تم تحميلها.

    https://us.atlas.microsoft.com/conversions?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2023-03-01-preview&udid={udid}&inputType=DWG&dwgPackageVersion=2.0

  6. حدد إرسال.

  7. حدد علامة تبويبالعنوان في نافذة الاستجابة.

  8. انسخ قيمة مفتاح Operation-Location. يحتوي على عنوان URL للحالة الذي تستخدمه للتحقق من حالة التحويل.

    Screenshot of Postman that shows the URL value of the operation location key in the response header.

التحقق من حالة تحويل حزمة الرسم

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

للتحقق من حالة عملية التحويل واسترداد conversionId القيمة:

  1. حدد New في تطبيق Postman.

  2. ومن نافذة إنشاء جديد حدد طلب HTTP.

  3. بالنسبة إلى اسم الطلب، أدخل اسما للطلب، مثل حالة تحويل GET.

  4. حدد أسلوب HTTP ليكون ⁧⁩ GET⁧⁩.

  5. أدخل عنوان URL للحالة الذي نسخته في المقطع تحويل حزمة رسم. يجب أن يبدو الطلب مثل عنوان URL التالي:

    https://us.atlas.microsoft.com/conversions/operations/{operationId}?api-version=2.0&subscription-key={Your-Azure-Maps-Subscription-key}

  6. حدد ⁧⁩Send⁧⁩.

  7. حدد علامة تبويبالعنوان في نافذة الاستجابة.

  8. انسخ قيمة مفتاح Resource-Location ، وهو عنوان URL لموقع المورد. يحتوي عنوان URL لموقع المورد على المعرف conversionIdالفريد ، الذي تستخدمه واجهات برمجة التطبيقات الأخرى للوصول إلى بيانات الخريطة المحولة.

    Screenshot of Postman that highlights the conversion ID value that appears in the Resource-Location key in the response header.

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

تعرض تجزئة JSON التالي عينة من عينات التحذير أثناء التحويل:

{
    "operationId": "{operationId}",
    "created": "2021-05-19T18:24:28.7922905+00:00",
    "status": "Succeeded",
     "warning": {
        "code": "dwgConversionProblem",
        "details": [
            {
                "code": "warning",
                "details": [
                    {
                        "code": "manifestWarning",
                        "message": "Ignoring unexpected JSON property: unitProperties[0].nonWheelchairAccessible with value False"
                    }
                ]
            }
        ]
    },
    "properties": {
        "diagnosticPackageLocation": "https://atlas.microsoft.com/mapData/ce61c3c1-faa8-75b7-349f-d863f6523748?api-version=1.0"
    }
}

إنشاء مجموعة بيانات

مجموعة البيانات هي مجموعة تضم ميزات الخريطة مثل المباني والمستويات والغرف. لإنشاء قاعدة بيانات استخدم Dataset Create API. تأخذ conversionId Dataset Create API قيمة حزمة الرسم المحولة وترجع قيمة لمجموعة البيانات التي تم إنشاؤها datasetId .

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

  1. حدد New في تطبيق Postman.

  2. ومن نافذة إنشاء جديد حدد طلب HTTP.

  3. بالنسبة إلى اسم الطلب، أدخل اسما للطلب، مثل POST Dataset Create.

  4. حدد أسلوبPOST HTTP.

  5. أدخل عنوان URL التالي في خدمة مجموعة البيانات. استبدل {conversionId} بالقيمة conversionId التي حصلت عليها في التحقق من حالة تحويل حزمة الرسم.

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

  6. حدد إرسال.

  7. حدد علامة تبويبالعنوان في نافذة الاستجابة.

  8. انسخ قيمة مفتاح Operation-Location. يحتوي على عنوان URL للحالة الذي تستخدمه للتحقق من حالة مجموعة البيانات.

    Screenshot of Postman that shows the value of the Operation-Location key for a dataset in the response header.

تحقق من حالة إنشاء مجموعة البيانات

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

  1. حدد New في تطبيق Postman.

  2. ومن نافذة إنشاء جديد حدد طلب HTTP.

  3. بالنسبة إلى اسم الطلب، أدخل اسما للطلب، مثل GET Dataset Status.

  4. حدد أسلوب HTTP ليكون ⁧⁩ GET⁧⁩.

  5. أدخل عنوان URL للحالة الذي نسخته في قسم إنشاء مجموعة بيانات. يجب أن يبدو الطلب مثل عنوان URL التالي:

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

  6. حدد ⁧⁩Send⁧⁩.

  7. في نافذة الاستجابة، حدد علامة التبويب الرؤوس . قيمة مفتاح Resource-Location هي عنوان URL لموقع المورد. يحتوي عنوان URL لموقع المورد على المعرف الفريد (datasetId) لمجموعة البيانات.

  8. احفظ قيمة datasetId، لأنك ستستخدمها في البرنامج التعليمي التالي.

    Screenshot of Postman that shows the dataset ID value of the Resource-Location key in the response header.

أنشئ tileset

tileset هو مجموعة من مربعات المتجهات المعروضة على الخريطة. يتم إنشاء Tilesets من مجموعة البيانات الموجودة بالفعل. ومع ذلك، فإن مجموعة الإطارات المتجانبة مستقلة عن مجموعة البيانات التي تأتي منها. إذا حُذفت مجموعة البيانات فسيستمر وجود Tileset.

لإنشاء tileset:

  1. حدد New في تطبيق Postman.

  2. ومن نافذة إنشاء جديد حدد طلب HTTP.

  3. بالنسبة إلى اسم الطلب، أدخل اسما للطلب، مثل POST Tileset Create.

  4. حدد أسلوبPOST HTTP.

  5. أدخل عنوان URL التالي في خدمة Tileset. استبدل {datasetId} بالقيمة datasetId التي حصلت عليها في قسم التحقق من حالة إنشاء مجموعة البيانات.

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

  6. حدد إرسال.

  7. حدد علامة تبويبالعنوان في نافذة الاستجابة.

  8. انسخ قيمة مفتاح Operation-Location. يحتوي على عنوان URL للحالة، الذي تستخدمه للتحقق من حالة مجموعة الإطارات المتجانبة.

    Screenshot of Postman that shows the status URL, which is the value of the Operation-Location key in the response header.

التحقق من حالة إنشاء مجموعة الإطارات المتجانبة

للتحقق من حالة عملية إنشاء مجموعة الإطارات المتجانبة واسترداد tilesetId القيمة:

  1. حدد New في تطبيق Postman.

  2. ومن نافذة إنشاء جديد حدد طلب HTTP.

  3. بالنسبة إلى اسم الطلب، أدخل اسما للطلب، مثل GET Tileset Status.

  4. حدد أسلوب HTTP ليكون ⁧⁩ GET⁧⁩.

  5. أدخل عنوان URL للحالة الذي نسخته في قسم Create a tileset . يجب أن يبدو الطلب مثل عنوان URL التالي:

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

  6. حدد ⁧⁩Send⁧⁩.

  7. في نافذة الاستجابة، حدد علامة التبويب الرؤوس . قيمة مفتاح Resource-Location هي عنوان URL لموقع المورد. يحتوي عنوان URL لموقع المورد على المعرف الفريد (tilesetId) لمجموعة البيانات.

    Screenshot of Postman that shows the tileset ID, which is part of the value of the resource location URL in the response header.

الحصول على تكوين الخريطة (معاينة)

بعد إنشاء tileset، يمكنك الحصول على mapConfigurationId القيمة باستخدام tileset الحصول على طلب HTTP:

  1. حدد New في تطبيق Postman.

  2. ومن نافذة إنشاء جديد حدد طلب HTTP.

  3. بالنسبة إلى اسم الطلب، أدخل اسما للطلب، مثل GET mapConfigurationId من Tileset.

  4. حدد أسلوب HTTP ليكون ⁧⁩ GET⁧⁩.

  5. أدخل عنوان URL التالي في خدمة Tileset. مرر معرف مجموعة الإطارات المتجانبة الذي حصلت عليه في الخطوة السابقة.

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

  6. حدد إرسال.

  7. يظهر tileset JSON في نص الاستجابة. مرر لأسفل لرؤية mapConfigurationId القيمة:

    "defaultMapConfigurationId": "5906cd57-2dba-389b-3313-ce6b549d4396"

لمزيد من المعلومات، راجع تكوين الخريطة في المقالة حول مفاهيم الخريطة الداخلية.

الخطوات التالية

ما هو خرائط Azure Creator؟

منشئ الخرائط الداخلية

استخدام وحدة الخرائط الداخلية خرائط Azure مع أنماط مخصصة