إنشاء أنماط مخصصة للخرائط الداخلية (معاينة)

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

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

إنشاء أنماط مخصصة باستخدام محرر مرئيات المبدعين

في حين أنه من الممكن تعديل أنماط الخرائط الداخلية باستخدام Creators Rest API، يوفر Creator أيضا محرر أنماط مرئية لإنشاء أنماط مخصصة لا تتطلب ترميز. تركز هذه المقالة بشكل حصري على إنشاء أنماط مخصصة باستخدام محرر الأنماط هذا.

نمط مفتوح

عند إنشاء خريطة داخلية في خدمة خرائط Azure Creator، يتم إنشاء الأنماط الافتراضية تلقائيا لك. لتخصيص عناصر التصميم في الخريطة الداخلية، افتح هذا النمط الافتراضي.

افتح محرر الأنماط وحدد الزر فتح شريط الأدوات.

A screenshot of the open menu in the visual style editor.

يتم فتح مربع الحوار فتح نمط .

أدخل مفتاح الاشتراك في حقل مفتاح اشتراكك في خرائط Azure.

بعد ذلك، حدد الجغرافيا المقترنة بمفتاح الاشتراك في القائمة المنسدلة.

A screenshot of the open dialog box in the visual style editor.

حدد الزر Get map configuration list للحصول على قائمة بكل تكوين خريطة مقترن بمورد Creator النشط.

A screenshot of the open style dialog box in the visual style editor with the Select map configuration drop-down list highlighted.

إشعار

إذا تم إنشاء تكوين الخريطة كجزء من نمط مخصص وتم توفير اسم مستعار لمستخدم، يظهر هذا الاسم المستعار في القائمة المنسدلة لتكوين الخريطة، وإلا يظهر فقط mapConfigurationId . يمكن العثور على معرف تكوين الخريطة الافتراضي لأي مجموعة تجانب معينة باستخدام مجموعة الإطارات المتجانبة الحصول على طلب HTTP وتمريره في معرف مجموعة الإطارات المتجانبة:

https://{geography}.atlas.microsoft.com/tilesets/{tilesetId}?2023-03-01-preview

mapConfigurationId يتم إرجاع في نص الاستجابة، على سبيل المثال:

"defaultMapConfigurationId": "68d74ad9-4f84-99ce-06bb-19f487e8e692"

بمجرد تحديد تكوين الخريطة المطلوب، تظهر القائمة المنسدلة للأنماط.

بمجرد تحديد النمط المطلوب، حدد الزر تحميل النمط المحدد.

حول مربع حوار النمط المفتوح

A screenshot of the Open Style dialog box in the visual style editor, with each edit field numbered, each number correlates to the numbers in the following table.

# ‏‏الوصف
1 مفتاح الاشتراك في حساب خرائط Azure
2 حدد جغرافية حساب خرائط Azure.
3 قائمة بمعرفات تكوين الخريطة والأسماء المستعارة.
4 قائمة بالأنماط المقترنة بتكوين الخريطة المحدد.

تعديل النمط

بمجرد فتح نمطك في المحرر المرئي، يمكنك البدء في تعديل العناصر المختلفة لخريطة الأماكن المغلقة مثل تغيير ألوان الخلفية لقاعات المؤتمرات أو المكاتب أو المراحيض. يمكنك أيضا تغيير حجم الخط للتسميات مثل أرقام المكاتب وتحديد ما يظهر على مستويات تكبير/تصغير مختلفة.

تغيير لون الخلفية

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

A screenshot of the unit layer pop-up dialog box in the visual style editor.

افتح لوح الألوان وحدد اللون الذي ترغب في تغيير الوحدة المحددة إليه.

A screenshot of the color pallet in the visual style editor.

خريطة أساسية

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

A screenshot of the base maps drop-down list in the visual editor toolbar.

حفظ الأنماط المخصصة

بمجرد إجراء التغييرات المطلوبة على أنماطك، احفظ التغييرات في مورد "المنشئ". يمكنك الكتابة فوق النمط باستخدام التغييرات أو إنشاء نمط جديد.

لحفظ التغييرات، حدد الزر حفظ على شريط الأدوات.

A screenshot of the save menu in the visual style editor.

يؤدي ذلك إلى إظهار مربع حوار تكوين نمط التحميل والخريطة:

A screenshot of the upload style and map configuration dialog box in the visual style editor.

يصف الجدول التالي الحقول الأربعة التي تم تقديمك بها.

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

بعض الأشياء المهمة التي يجب معرفتها حول الأسماء المستعارة:

  1. يمكن تسميتها باستخدام الأحرف الأبجدية الرقمية (0-9، a-z، A-Z)، الواصلات (-) والتسطير السفلي (_).
  2. يمكن استخدامها للإشارة إلى تكوين الخريطة الأساسي، بدلا من معرف هذا الكائن. هذا مهم بشكل خاص نظرا لأنه لا يمكن تحديث تكوين الخريطة، مما يعني أنه في كل مرة يتم فيها حفظ أي تغييرات، يتم إنشاء معرف جديد، ولكن يمكن أن يظل الاسم المستعار كما هو، ما يجعله أقل عرضة للخطأ بعد تعديله عدة مرات.

تحذير

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

بمجرد إدخال القيم في كل حقل مطلوب، حدد الزر Upload map configuration لحفظ النمط وتعيين بيانات التكوين إلى مورد Creator.

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

A screenshot of the upload complete dialog box in the visual style editor showing values for the Style ID, Map configuration ID and the map configuration alias.

تلميح

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

الفئات المخصصة

قام خرائط Azure Creator بتعريف قائمة بالفئات. عند إنشاء البيان الخاص بك، يمكنك إقران كل وحدة في مرفقك بإحدى هذه الفئات في عنصر unitProperties.

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

للقيام بذلك، أدخل القيمة المطلوبة في categoryName للمطلوب unitName في بيان JSON قبل تحميل حزمة الرسم الخاصة بك.

A screenshot showing the custom category name in the manifest.

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

A screenshot showing the difference in the layers that appear after changing the category name in the manifest.

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

A screenshot the duplicate button in the layers pane in the visual editor toolbar, along with the layer ID showing the name of the new layer that is the same as the original layer with a dash copy added to the end.

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

على سبيل المثال، قد يبدو JSON مثل هذا:

{
  "id": "indoor_unit_room_accessible",
  "type": "fill",
  "filter": [
    "all",
    ["has", "floor0"],
    [
      "any",
      [
        "case",
        [
          "==",
          [
            "typeof",
            ["get", "categoryName"]
          ],
          "string"
        ],
        [
          "==",
          ["get", "categoryName"],
          "room.accessible.phone"
        ],
        false
      ]
    ]
  ],
  "layout": {"visibility": "visible"},
  "metadata": {
    "microsoft.maps:layerGroup": "unit"
  },
  "minzoom": 16,
  "paint": {
    "fill-antialias": true,
    "fill-color": [
      "string",
      ["feature-state", "color"],
      "rgba(230, 230, 230, 1)"
    ],
    "fill-opacity": 1,
    "fill-outline-color": "rgba(120, 120, 120, 1)"
  },
  "source-layer": "Indoor unit",
  "source": "{tilesetId}"
}

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

على سبيل المثال، قد يبدو عامل التصفية JSON كما يلي:

[
  "all",
  ["has", "floor0"],
  [
    "any",
    [
      "case",
      [
        "==",
        [
          "typeof",
          ["get", "categoryName"]
        ],
        "string"
      ],
      [
        "==",
        ["get", "categoryName"],
        "room.accessible.phone"
      ],
      false
    ]
  ]
]

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

A screenshot of the pop-up menu showing the new layer appearing when the phone 11 unit is selected.

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