عرض بيانات مخصصة على مخطط نقطي

توضح هذه المقالة كيفية استخدام الأمر Get Map Static Image مع وظيفة تكوين الصورة. تدعم وظيفة تكوين الصورة استرداد تجانبات النقط الثابتة التي تحتوي على بيانات مخصصة.

فيما يلي أمثلة على البيانات المخصصة:

• دبابيس تثبيت مخصصة
• بطاقات عنونة
• تراكبات هندسية

تلميح

لعرض مخطط بسيط على صفحة ويب، غالباً ما يكون استخدام عدة تطوير برامج الويب في خرائط Azure أكثر فعالية من حيث التكلفة، بدلاً من استخدام خدمة الصور الثابتة. تستخدم عدة تطوير برامج الويب صور مصغرة من الخريطة؛ وما لم يقم المستخدم بتحريك المخطط وتكبيره، فإنه غالباً ما ينشئ جزءاً صغيراً فقط من العملية لكل تحميل للمخطط. يحتوي خرائط Azure Web SDK على خيارات لتعطيل التحريك والتكبير/التصغير. كما يوفر خرائط Azure Web SDK مجموعة أكثر ثراء من خيارات تصور البيانات مقارنة بخدمة ويب الخريطة الثابتة.

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

• حساب خرائط Azure
• مفتاح الاشتراك

تستخدم هذه المقالة تطبيق Postman، ولكن يمكنك استخدام بيئة تطوير واجهة برمجة تطبيقات مختلفة.

هام

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

عرض دبابيس التثبيت مع ملصقات وصور مخصصة

إشعار

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

إيقاف مستوى تسعير خرائط Azure Gen1

تم الآن إهمال مستوى تسعير Gen1 وسيتم إيقافه في 9/15/26. يحل مستوى تسعير Gen2 محل مستوى تسعير Gen1 (كل من S0 وS1). إذا تم تحديد مستوى تسعير Gen1 لحساب خرائط Azure الخاص بك، يمكنك التبديل إلى تسعير Gen2 قبل إيقافه، وإلا فسيتم تحديثه تلقائيا. لمزيد من المعلومات، راجع إدارة مستوى التسعير لحساب خرائط Azure الخاص بك.

الحصول على صورة ثابتة مع دبابيس وتسميات مخصصة

للحصول على صورة ثابتة مع دبابيس وتسميات مخصصة:

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

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

3. أدخل اسم الطلب للطلب، مثل Get Map Static Image.

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

5. أدخل عنوان URL التالي.

   https://atlas.microsoft.com/map/static/png?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2022-08-01&layer=basic&style=main&zoom=12&center=-73.98,%2040.77&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27CentralPark%27-73.9657974+40.781971%7C%7Chttps%3A%2F%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png
   

6. حدد ⁧⁩Send⁧⁩.

7. تقوم الخدمة بإرجاع الصورة التالية:

   

عرض مضلع مع اللون والشفافية

إشعار

يتطلب الإجراء في هذا القسم مستوى تسعير حساب خرائط Azure Gen1 (S1) أو Gen2.

يمكنك تعديل مظهر المضلع باستخدام أدوات تعديل النمط مع معلمة المسار.

لعرض مضلع مع اللون والشفافية:

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

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

3. أدخِل اسم الطلب للطلب، مثل GET Polygon.

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

5. أدخل عنوان URL التالي في خدمة Render :

   https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&style=main&layer=basic&sku=S1&zoom=14&height=500&Width=500&center=-74.040701, 40.698666&path=lc0000FF|fc0000FF|lw3|la0.80|fa0.50||-74.03995513916016 40.70090237454063|-74.04082417488098 40.70028420372218|-74.04113531112671 40.70049568385827|-74.04298067092896 40.69899904076542|-74.04271245002747 40.69879568992435|-74.04367804527283 40.6980961582905|-74.04364585876465 40.698055487620714|-74.04368877410889 40.698022951066996|-74.04168248176573 40.696444909137|-74.03901100158691 40.69837271818651|-74.03824925422668 40.69837271818651|-74.03809905052185 40.69903971085914|-74.03771281242369 40.699340668780984|-74.03940796852112 40.70058515602143|-74.03948307037354 40.70052821920425|-74.03995513916016 40.70090237454063
   &subscription-key={Your-Azure-Maps-Subscription-key}
   

6. تقوم الخدمة بإرجاع الصورة التالية:

   

عرض دائرة ودبابيس تثبيت مع تسميات مخصصة

إشعار

يتطلب الإجراء في هذا القسم مستوى تسعير حساب خرائط Azure Gen1 (S1) أو Gen2.

يمكنك تعديل مظهر الدبابيس عن طريق إضافة أدوات تعديل النمط. على سبيل المثال، لجعل دبابيس التثبيت وتسمياتها أكبر أو أصغر، استخدم أداة تعديل "نمط المقياس" sc. تأخذ أداة التعديل هذه قيمة أكبر من الصفر. القيمة 1 هي المقياس القياسي. القيم الأكبر من 1 تجعل الدبابير أكبر، والقيم الأصغر من 1 تجعلها أصغر. لمزيد من المعلومات حول معدلات الأنماط، راجع معلمة المسار للأمر Get Map Static Image.

لعرض دائرة ودبابيس تثبيت مع تسميات مخصصة:

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

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

3. أدخِل اسم الطلب للطلب، مثل GET Polygon.

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

5. أدخل عنوان URL التالي في خدمة Render :

   https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&style=main&layer=basic&zoom=14&height=700&Width=700&center=-122.13230609893799,47.64599069048016&path=lcFF0000|lw2|la0.60|ra1000||-122.13230609893799 47.64599069048016&pins=default|la15+50|al0.66|lc003C62|co002D62||'Microsoft Corporate Headquarters'-122.14131832122801  47.64690503939462|'Microsoft Visitor Center'-122.136828 47.642224|'Microsoft Conference Center'-122.12552547454833 47.642940335653996|'Microsoft The Commons'-122.13687658309935  47.64452336193245&subscription-key={Your-Azure-Maps-Subscription-key}
   

6. حدد إرسال.

7. تقوم الخدمة بإرجاع الصورة التالية:

   

8. بعد ذلك، قم بتغيير لون دبابيس التثبيت عن طريق تعديل co معدل النمط. إذا نظرت إلى قيمة المعلمة pins (pins=default|la15+50|al0.66|lc003C62|co002D62|)، فلاحظ أن اللون الحالي هو #002D62. لتغيير اللون إلى #41d42a، استبدل #002D62 ب #41d42a. الآن المعلمة pins هي pins=default|la15+50|al0.66|lc003C62|co41D42A|. يبدو الطلب مثل عنوان URL التالي:

   https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&style=main&layer=basic&zoom=14&height=700&Width=700&center=-122.13230609893799,47.64599069048016&path=lcFF0000|lw2|la0.60|ra1000||-122.13230609893799 47.64599069048016&pins=default|la15+50|al0.66|lc003C62|co41D42A||'Microsoft Corporate Headquarters'-122.14131832122801  47.64690503939462|'Microsoft Visitor Center'-122.136828 47.642224|'Microsoft Conference Center'-122.12552547454833 47.642940335653996|'Microsoft The Commons'-122.13687658309935  47.64452336193245&subscription-key={Your-Azure-Maps-Subscription-key}
   

9. حدد إرسال.

10. تقوم الخدمة بإرجاع الصورة التالية:

    

وبالمثل، يمكنك تغيير أدوات تعديل النمط الأخرى وإضافتها وإزالتها.

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

العرض - الحصول على صورة ثابتة للخريطة