Share via

أنشئ ميزة مجموعة البيانات

  • مقالة

تحدد Feature statesets الخصائص والقيم الديناميكية لميزات معينة تدعمها. توضح هذه المقالة كيفية إنشاء مجموعة حالات تحدد القيم والأنماط المقابلة لخاصية وتغيير حالة الخاصية.

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

هام

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

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

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

إنشاء طلب HTTP POST جديد يستخدم واجهة برمجة تطبيقات Stateset. يجب أن يبدو الطلب مثل عنوان URL التالي:

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

بعد ذلك، قم بتعيين Content-Type إلى application/json في رأس الطلب.

إذا كنت تستخدم أداة مثل Postman، يجب أن تبدو كما يلي:

A screenshot of Postman showing the Header tab of the POST request that shows the Content Type Key with a value of application forward slash json.

وأخيرا، في نص طلب HTTP، قم بتضمين معلومات النمط بتنسيق JSON الخام، والذي يطبق ألوانا مختلفة على الخاصية occupied اعتمادا على قيمتها:

{
    "styles":[
        {
            "keyname":"occupied",
            "type":"boolean",
            "rules":[
            {
                "true":"#FF0000",
                "false":"#00FF00"
            }
            ]
        }
    ]
}

بعد نجاح استرجاع الاستجابة، انسخ statesetId من نص الاستجابة. في القسم التالي، ستستخدم statesetId لتغيير حالة خاصية occupancy للوحدة ذات الميزة id "UNIT26". في حالة استخدام Postman، يظهر على النحو التالي:

A screenshot of Postman showing the resource Stateset ID value in the responses body.

حدث ميزة الحالة

يوضح هذا القسم كيفية تحديث occupied حالة الوحدة بميزة id "UNIT26". لتحديث occupied الحالة، قم بإنشاء طلب HTTP PUT جديد يستدعي واجهة برمجة تطبيقات Feature Stateets. يجب أن يبدو الطلب مثل عنوان URL التالي (استبدل {statesetId} ب الذي statesetId تم الحصول عليه في Create a feature stateset):

https://us.atlas.microsoft.com/featurestatesets/{statesetId}/featureStates/UNIT26?api-version=2.0&subscription-key={Your-Azure-Maps-Subscription-key}

بعد ذلك، قم بتعيين Content-Type إلى application/json في رأس الطلب.

إذا كنت تستخدم أداة مثل Postman، يجب أن تبدو كما يلي:

A screenshot of the header tab information for stateset creation.

وأخيرا، في نص طلب HTTP، قم بتضمين معلومات النمط بتنسيق JSON الخام، والذي يطبق ألوانا مختلفة على الخاصية occupied اعتمادا على قيمتها:

{
    "states": [
        {
            "keyName": "occupied",
            "value": true,
            "eventTimestamp": "2020-11-14T17:10:20"
        }
    ]
}

إشعار

سيتم حفظ التحديث فقط إذا وقع الطابع الزمني الذي تم ترحيله بعد الطابع الزمني للطلب السابق.

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

معلومات اضافيه

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

تعرف على كيفية تنفيذ التصميم الديناميكي للخرائط الداخلية.

التصميم الديناميكي