مشاركة عبر

RenderGetMapStaticImageQueryParamProperties interface

  • ‏‏المرجع
الحزمة:
@azure-rest/maps-render

الخصائص

bbox

مربع الإحاطة. الإسقاط المستخدم - EPSG:3857. Format : 'minLon, minLat, maxLon, maxLat'.

ملاحظة: إما أن bbox أو center معلمات مطلوبة. فهي حصرية بشكل متبادل. لا ينبغي استخدامه مع الارتفاع أو العرض.

يتم تحديد الحد الأقصى للنطاقات المسموح بها ل Lat وLon لكل مستوى تكبير/تصغير في الجدول أعلى هذه الصفحة.
center

إحداثيات النقطة المركزية. التنسيق: 'lon,lat'. الإسقاط المستخدم

  • EPSG:3857. نطاق خط الطول: -180 إلى 180. نطاق خط العرض: من -85 إلى 85.

ملاحظة: إما أن يكون الوسط أو مربع bbox معلمات مطلوبة. فهي حصرية بشكل متبادل.
height

ارتفاع الصورة الناتجة بالبكسل. النطاق من 1 إلى 8192. الافتراضي هو 512. لا ينبغي استخدامه مع bbox.
language

اللغة التي يجب إرجاع نتائج البحث بها. يجب أن تكون واحدة من علامات لغة IETF المدعومة، غير حساسة لحالة الأحرف. عندما لا تتوفر البيانات بلغة محددة لحقل معين، يتم استخدام اللغة الافتراضية.

يرجى الرجوع إلى اللغات المدعومة للحصول على التفاصيل.
layer

طلب طبقة الخريطة. إذا تم تعيين الطبقة إلى تسميات أو هجينة، يجب أن يكون التنسيق png.
path

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

يتم دعم معلمة المسار في حساب خرائط Azure SKU بدءا من S1. تسمح مثيلات متعددة لمعلمة المسار بتحديد هندسة متعددة بأنماطها. يقتصر عدد المعلمات لكل طلب على 10 وعدد المواقع يقتصر على 100 لكل مسار.

لعرض دائرة ذات نصف قطر 100 متر ونقطة مركزية عند خط العرض 45 درجة شمالا وخط الطول 122 درجة غربا باستخدام النمط الافتراضي، أضف معلمة سلسلة الاستعلام

path=ra100||-122 45

لاحظ أن خط الطول يأتي قبل خط العرض. بعد ترميز عنوان URL، سيبدو هذا مثل

path=ra100%7C%7C-122+45

تظهر جميع الأمثلة هنا معلمة المسار دون ترميز عنوان URL، للوضوح.

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

path=||-122 45|-119.5 43.2|-121.67 47.12

لعرض مضلع، يجب أن يكون الموقع الأخير مساويا لموقع البدء. على سبيل المثال، عليك استخدام

path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45

يمكن أن تكون قيم خط الطول وخط العرض لمواقع الخطوط والمضلعات في النطاق من -360 إلى 360 للسماح بعرض الهندسة التي تعبر خط الطول المضاد.

معدلات الأنماط

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

لتغيير لون المخطط التفصيلي، استخدم معدل النمط "lc" وحدد اللون باستخدام تنسيق لون HTML/CSS RGB وهو رقم سداسي عشري مكون من ستة أرقام (النموذج المكون من ثلاثة أرقام غير معتمد). على سبيل المثال، لاستخدام لون وردي عميق يمكنك تحديده على أنه #FF1493 في CSS، استخدم

path=lcFF1493||-122 45|-119.5 43.2

يمكن دمج معدلات أنماط متعددة معا لإنشاء نمط مرئي أكثر تعقيدا.

lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6

ملخص معدل النمط

المعدل الوصف النطاق
Lc لون الخط 0000000 إلى FFFFFF
نادي لون التعبئة 0000000 إلى FFFFFF
la سطر ألفا (التعتيم) من 0 إلى 1
fa تعبئة ألفا (التعتيم) من 0 إلى 1
lw عرض الخط أكبر من 0
را دائرة نصف قطرها (متر) أكبر من 0
pins

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

يدعم حساب خرائط Azure S0 SKU مثيلا واحدا فقط لمعلمة pins. تسمح وحدات SKU الأخرى لمثيلات متعددة لمعلمة الدبابيس بتحديد أنماط دبوس متعددة.

لعرض دبوس دفع عند خط العرض 45°N وخط الطول 122°W باستخدام نمط دبوس التثبيت المضمن الافتراضي، أضف معلمة سلسلة الاستعلام

pins=default||-122 45

لاحظ أن خط الطول يأتي قبل خط العرض. بعد ترميز عنوان URL، سيبدو هذا كما يلي

pins=default%7C%7C-122+45

تظهر جميع الأمثلة هنا معلمة دبابيس بدون ترميز عنوان URL، للوضوح.

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

pins=default||-122 45|-119.5 43.2|-121.67 47.12

يسمح SKU لحساب S0 خرائط Azure بخمسة دبابيس دفع فقط. لا تحتوي وحدات SKU للحساب الأخرى على هذا القيد.

معدلات الأنماط

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

لتغيير لون دبوس التثبيت، استخدم معدل النمط "co" وحدد اللون باستخدام تنسيق لون HTML/CSS RGB وهو رقم سداسي عشري مكون من ستة أرقام (النموذج المكون من ثلاثة أرقام غير معتمد). على سبيل المثال، لاستخدام لون وردي عميق يمكنك تحديده على أنه #FF1493 في CSS، استخدم

pins=default|coFF1493||-122 45

تسميات دبوس التثبيت

لإضافة تسمية إلى الدبابيس، ضع التسمية في علامات اقتباس مفردة قبل الإحداثيات. على سبيل المثال، لتسمية ثلاثة دبابيس بالقيم "1" و"2" و"3"، استخدم

pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

هناك نمط دبوس تثبيت مضمن يسمى "لا شيء" لا يعرض صورة دبوس التثبيت. يمكنك استخدام هذا إذا كنت تريد عرض التسميات دون أي صورة دبوس. على سبيل المثال،

pins=none||'A'-122 45|'B'-119.5 43.2

لتغيير لون تسميات دبوس التثبيت، استخدم معدل نمط لون التسمية 'lc'. على سبيل المثال، لاستخدام دبابيس دفع وردية مع تسميات سوداء، استخدم

pins=default|coFF1493|lc000000||-122 45

لتغيير حجم التسميات، استخدم معدل نمط حجم التسمية "ls". يمثل حجم التسمية الارتفاع التقريبي لنص التسمية بالبكسل. على سبيل المثال، لزيادة حجم التسمية إلى 12، استخدم

pins=default|ls12||'A'-122 45|'B'-119 43

يتم توسيط التسميات في دبوس التثبيت 'ارتساء التسمية.' موقع الارتساء محدد مسبقا ل دبابيس التثبيت المضمنة وهو في أعلى وسط دبابيس التثبيت المخصصة (انظر أدناه). لتجاوز ارتساء التسمية، باستخدام معدل النمط 'la' وتوفير إحداثيات X وY بكسل للارتساء. هذه الإحداثيات نسبة إلى الزاوية العلوية اليمنى من صورة دبوس التثبيت. تنقل قيم X الموجبة المرساة إلى اليمين، وتنقل قيم Y الموجبة الارتساء لأسفل. على سبيل المثال، لوضع مرساة التسمية 10 بكسل لليمين و4 بكسل فوق الزاوية العلوية اليمنى من صورة دبوس التثبيت، استخدم

pins=default|la10 -4||'A'-122 45|'B'-119 43

دبابيس دفع مخصصة

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

pins=custom||-122 45||http://contoso.com/pushpins/red.png

بعد ترميز عنوان URL، سيبدو هذا كما يلي

pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png

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

pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png

ملاحظة: إذا كنت تستخدم معدل اللون "co" مع صورة دبوس ضغط مخصص، فسيحل اللون المحدد محل قنوات RGB للبكسل في الصورة ولكنه سيترك قناة ألفا (التعتيم) دون تغيير. عادة ما يتم ذلك فقط مع صورة مخصصة ذات لون خالص.

المقياس والاستدارة والشفافية

يمكنك جعل دبابيس التثبيت وتسمياتها أكبر أو أصغر باستخدام معدل نمط مقياس 'sc'. هذه قيمة أكبر من الصفر. القيمة 1 هي المقياس القياسي. القيم الأكبر من 1 ستجعل الدبابيس أكبر، والقيم الأصغر من 1 ستجعلها أصغر. على سبيل المثال، لرسم دبابيس الدفع أكبر بنسبة 50٪ من المعتاد، استخدم

pins=default|sc1.5||-122 45

يمكنك تدوير دبابيس التثبيت وتسمياتها باستخدام معدل نمط الاستدارة "ro". هذا عدد من درجات الدوران باتجاه عقارب الساعة. استخدم رقما سالبا لتدوير عكس اتجاه عقارب الساعة. على سبيل المثال، لتدوير دبابيس الدفع 90 درجة باتجاه عقارب الساعة ومضاعفة حجمها، استخدم

pins=default|ro90|sc2||-122 45

يمكنك جعل دبابيس التثبيت وتسمياتها شفافة جزئيا عن طريق تحديد معدل نمط ألفا "al". هذا رقم بين 0 و1 يشير إلى شفافية دبابيس التثبيت. صفر يجعلها شفافة تماما (وغير مرئية) و1 يجعلها مبهمة تماما (وهو الافتراضي). على سبيل المثال، لجعل دبابيس التثبيت وتسمياتها غير شفافة بنسبة 67٪ فقط، استخدم

pins=default|al.67||-122 45

ملخص معدل النمط

المعدل الوصف النطاق
al ألفا (شفافية) من 0 إلى 1
an تثبيت الارتساء *
co لون الدبوس 000000 إلى FFFFFF
la ارتساء التسمية *
Lc لون التسمية 000000 إلى FFFFFF
هل حجم التسمية أكبر من 0
ro التدوير -360 إلى 360
Sc المقياس أكبر من 0
  • يمكن أن تكون إحداثيات X وY في أي مكان داخل صورة الدبوس أو هامش حولها. حجم الهامش هو الحد الأدنى لعرض الدبوس وارتفاعه.
style

نمط الخريطة المراد إرجاعه. القيم المحتملة هي الرئيسية والظلام.
view

تسمح لك معلمة View (تسمى أيضا المعلمة "منطقة المستخدم") بإظهار الخرائط الصحيحة لبلد/منطقة معينة للمناطق المتنازع عليها جغرافيا. لدى البلدان/المناطق المختلفة طرق عرض مختلفة لمثل هذه المناطق، وتسمح المعلمة View لتطبيقك بالامتثال للعرض المطلوب من قبل البلد/المنطقة التي سيخدمها تطبيقك. بشكل افتراضي، يتم تعيين المعلمة View إلى "Unified" حتى إذا لم تكن قد قمت بتعريفها في الطلب. تقع على عاتقك مسؤولية تحديد موقع المستخدمين، ثم تعيين المعلمة View بشكل صحيح لهذا الموقع. بدلا من ذلك، لديك خيار تعيين "View=Auto"، والذي سيعيد بيانات الخريطة استنادا إلى عنوان IP للطلب. يجب استخدام المعلمة View في خرائط Azure وفقا للقوانين المعمول بها، بما في ذلك تلك المتعلقة بالتعيين، للبلد/المنطقة حيث تتوفر الخرائط والصور والبيانات الأخرى ومحتوى الجهات الخارجية المصرح لك بالوصول إليه عبر خرائط Azure. مثال: view=IN.

يرجى الرجوع إلى طرق العرض المدعومة للحصول على التفاصيل والاطلاع على طرق العرض المتوفرة.
width

عرض الصورة الناتجة بالبكسل. النطاق من 1 إلى 8192. الافتراضي هو 512. لا ينبغي استخدامه مع bbox.
zoom

مستوى التكبير/التصغير المطلوب للخريطة. يجب أن تكون قيمة التكبير/التصغير في النطاق: 0-20 (شامل). القيمة الافتراضية هي 12.

يرجى مراجعة مستويات التكبير/التصغير وشبكة التجانب للحصول على التفاصيل.

تفاصيل الخاصية

bbox

مربع الإحاطة. الإسقاط المستخدم - EPSG:3857. Format : 'minLon, minLat, maxLon, maxLat'.

ملاحظة: إما أن bbox أو center معلمات مطلوبة. فهي حصرية بشكل متبادل. لا ينبغي استخدامه مع الارتفاع أو العرض.

يتم تحديد الحد الأقصى للنطاقات المسموح بها ل Lat وLon لكل مستوى تكبير/تصغير في الجدول أعلى هذه الصفحة.

bbox?: number[]

قيمة الخاصية

number[]

center

إحداثيات النقطة المركزية. التنسيق: 'lon,lat'. الإسقاط المستخدم

  • EPSG:3857. نطاق خط الطول: -180 إلى 180. نطاق خط العرض: من -85 إلى 85.

ملاحظة: إما أن يكون الوسط أو مربع bbox معلمات مطلوبة. فهي حصرية بشكل متبادل.

center?: number[]

قيمة الخاصية

number[]

height

ارتفاع الصورة الناتجة بالبكسل. النطاق من 1 إلى 8192. الافتراضي هو 512. لا ينبغي استخدامه مع bbox.

height?: number

قيمة الخاصية

number

language

اللغة التي يجب إرجاع نتائج البحث بها. يجب أن تكون واحدة من علامات لغة IETF المدعومة، غير حساسة لحالة الأحرف. عندما لا تتوفر البيانات بلغة محددة لحقل معين، يتم استخدام اللغة الافتراضية.

يرجى الرجوع إلى اللغات المدعومة للحصول على التفاصيل.

language?: string

قيمة الخاصية

string

layer

طلب طبقة الخريطة. إذا تم تعيين الطبقة إلى تسميات أو هجينة، يجب أن يكون التنسيق png.

layer?: "basic" | "hybrid" | "labels"

قيمة الخاصية

"basic" | "hybrid" | "labels"

path

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

يتم دعم معلمة المسار في حساب خرائط Azure SKU بدءا من S1. تسمح مثيلات متعددة لمعلمة المسار بتحديد هندسة متعددة بأنماطها. يقتصر عدد المعلمات لكل طلب على 10 وعدد المواقع يقتصر على 100 لكل مسار.

لعرض دائرة ذات نصف قطر 100 متر ونقطة مركزية عند خط العرض 45 درجة شمالا وخط الطول 122 درجة غربا باستخدام النمط الافتراضي، أضف معلمة سلسلة الاستعلام

path=ra100||-122 45

لاحظ أن خط الطول يأتي قبل خط العرض. بعد ترميز عنوان URL، سيبدو هذا مثل

path=ra100%7C%7C-122+45

تظهر جميع الأمثلة هنا معلمة المسار دون ترميز عنوان URL، للوضوح.

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

path=||-122 45|-119.5 43.2|-121.67 47.12

لعرض مضلع، يجب أن يكون الموقع الأخير مساويا لموقع البدء. على سبيل المثال، عليك استخدام

path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45

يمكن أن تكون قيم خط الطول وخط العرض لمواقع الخطوط والمضلعات في النطاق من -360 إلى 360 للسماح بعرض الهندسة التي تعبر خط الطول المضاد.

معدلات الأنماط

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

لتغيير لون المخطط التفصيلي، استخدم معدل النمط "lc" وحدد اللون باستخدام تنسيق لون HTML/CSS RGB وهو رقم سداسي عشري مكون من ستة أرقام (النموذج المكون من ثلاثة أرقام غير معتمد). على سبيل المثال، لاستخدام لون وردي عميق يمكنك تحديده على أنه #FF1493 في CSS، استخدم

path=lcFF1493||-122 45|-119.5 43.2

يمكن دمج معدلات أنماط متعددة معا لإنشاء نمط مرئي أكثر تعقيدا.

lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6

ملخص معدل النمط

المعدل الوصف النطاق
Lc لون الخط 0000000 إلى FFFFFF
نادي لون التعبئة 0000000 إلى FFFFFF
la سطر ألفا (التعتيم) من 0 إلى 1
fa تعبئة ألفا (التعتيم) من 0 إلى 1
lw عرض الخط أكبر من 0
را دائرة نصف قطرها (متر) أكبر من 0 
path?: string

قيمة الخاصية

string

pins

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

يدعم حساب خرائط Azure S0 SKU مثيلا واحدا فقط لمعلمة pins. تسمح وحدات SKU الأخرى لمثيلات متعددة لمعلمة الدبابيس بتحديد أنماط دبوس متعددة.

لعرض دبوس دفع عند خط العرض 45°N وخط الطول 122°W باستخدام نمط دبوس التثبيت المضمن الافتراضي، أضف معلمة سلسلة الاستعلام

pins=default||-122 45

لاحظ أن خط الطول يأتي قبل خط العرض. بعد ترميز عنوان URL، سيبدو هذا كما يلي

pins=default%7C%7C-122+45

تظهر جميع الأمثلة هنا معلمة دبابيس بدون ترميز عنوان URL، للوضوح.

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

pins=default||-122 45|-119.5 43.2|-121.67 47.12

يسمح SKU لحساب S0 خرائط Azure بخمسة دبابيس دفع فقط. لا تحتوي وحدات SKU للحساب الأخرى على هذا القيد.

معدلات الأنماط

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

لتغيير لون دبوس التثبيت، استخدم معدل النمط "co" وحدد اللون باستخدام تنسيق لون HTML/CSS RGB وهو رقم سداسي عشري مكون من ستة أرقام (النموذج المكون من ثلاثة أرقام غير معتمد). على سبيل المثال، لاستخدام لون وردي عميق يمكنك تحديده على أنه #FF1493 في CSS، استخدم

pins=default|coFF1493||-122 45

تسميات دبوس التثبيت

لإضافة تسمية إلى الدبابيس، ضع التسمية في علامات اقتباس مفردة قبل الإحداثيات. على سبيل المثال، لتسمية ثلاثة دبابيس بالقيم "1" و"2" و"3"، استخدم

pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

هناك نمط دبوس تثبيت مضمن يسمى "لا شيء" لا يعرض صورة دبوس التثبيت. يمكنك استخدام هذا إذا كنت تريد عرض التسميات دون أي صورة دبوس. على سبيل المثال،

pins=none||'A'-122 45|'B'-119.5 43.2

لتغيير لون تسميات دبوس التثبيت، استخدم معدل نمط لون التسمية 'lc'. على سبيل المثال، لاستخدام دبابيس دفع وردية مع تسميات سوداء، استخدم

pins=default|coFF1493|lc000000||-122 45

لتغيير حجم التسميات، استخدم معدل نمط حجم التسمية "ls". يمثل حجم التسمية الارتفاع التقريبي لنص التسمية بالبكسل. على سبيل المثال، لزيادة حجم التسمية إلى 12، استخدم

pins=default|ls12||'A'-122 45|'B'-119 43

يتم توسيط التسميات في دبوس التثبيت 'ارتساء التسمية.' موقع الارتساء محدد مسبقا ل دبابيس التثبيت المضمنة وهو في أعلى وسط دبابيس التثبيت المخصصة (انظر أدناه). لتجاوز ارتساء التسمية، باستخدام معدل النمط 'la' وتوفير إحداثيات X وY بكسل للارتساء. هذه الإحداثيات نسبة إلى الزاوية العلوية اليمنى من صورة دبوس التثبيت. تنقل قيم X الموجبة المرساة إلى اليمين، وتنقل قيم Y الموجبة الارتساء لأسفل. على سبيل المثال، لوضع مرساة التسمية 10 بكسل لليمين و4 بكسل فوق الزاوية العلوية اليمنى من صورة دبوس التثبيت، استخدم

pins=default|la10 -4||'A'-122 45|'B'-119 43

دبابيس دفع مخصصة

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

pins=custom||-122 45||http://contoso.com/pushpins/red.png

بعد ترميز عنوان URL، سيبدو هذا كما يلي

pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png

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

pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png

ملاحظة: إذا كنت تستخدم معدل اللون "co" مع صورة دبوس ضغط مخصص، فسيحل اللون المحدد محل قنوات RGB للبكسل في الصورة ولكنه سيترك قناة ألفا (التعتيم) دون تغيير. عادة ما يتم ذلك فقط مع صورة مخصصة ذات لون خالص.

المقياس والاستدارة والشفافية

يمكنك جعل دبابيس التثبيت وتسمياتها أكبر أو أصغر باستخدام معدل نمط مقياس 'sc'. هذه قيمة أكبر من الصفر. القيمة 1 هي المقياس القياسي. القيم الأكبر من 1 ستجعل الدبابيس أكبر، والقيم الأصغر من 1 ستجعلها أصغر. على سبيل المثال، لرسم دبابيس الدفع أكبر بنسبة 50٪ من المعتاد، استخدم

pins=default|sc1.5||-122 45

يمكنك تدوير دبابيس التثبيت وتسمياتها باستخدام معدل نمط الاستدارة "ro". هذا عدد من درجات الدوران باتجاه عقارب الساعة. استخدم رقما سالبا لتدوير عكس اتجاه عقارب الساعة. على سبيل المثال، لتدوير دبابيس الدفع 90 درجة باتجاه عقارب الساعة ومضاعفة حجمها، استخدم

pins=default|ro90|sc2||-122 45

يمكنك جعل دبابيس التثبيت وتسمياتها شفافة جزئيا عن طريق تحديد معدل نمط ألفا "al". هذا رقم بين 0 و1 يشير إلى شفافية دبابيس التثبيت. صفر يجعلها شفافة تماما (وغير مرئية) و1 يجعلها مبهمة تماما (وهو الافتراضي). على سبيل المثال، لجعل دبابيس التثبيت وتسمياتها غير شفافة بنسبة 67٪ فقط، استخدم

pins=default|al.67||-122 45

ملخص معدل النمط

المعدل الوصف النطاق
al ألفا (شفافية) من 0 إلى 1
an تثبيت الارتساء *
co لون الدبوس 000000 إلى FFFFFF
la ارتساء التسمية *
Lc لون التسمية 000000 إلى FFFFFF
هل حجم التسمية أكبر من 0
ro التدوير -360 إلى 360
Sc المقياس أكبر من 0
  • يمكن أن تكون إحداثيات X وY في أي مكان داخل صورة الدبوس أو هامش حولها. حجم الهامش هو الحد الأدنى لعرض الدبوس وارتفاعه.
pins?: string

قيمة الخاصية

string

style

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

style?: "main" | "dark"

قيمة الخاصية

"main" | "dark"

view

تسمح لك معلمة View (تسمى أيضا المعلمة "منطقة المستخدم") بإظهار الخرائط الصحيحة لبلد/منطقة معينة للمناطق المتنازع عليها جغرافيا. لدى البلدان/المناطق المختلفة طرق عرض مختلفة لمثل هذه المناطق، وتسمح المعلمة View لتطبيقك بالامتثال للعرض المطلوب من قبل البلد/المنطقة التي سيخدمها تطبيقك. بشكل افتراضي، يتم تعيين المعلمة View إلى "Unified" حتى إذا لم تكن قد قمت بتعريفها في الطلب. تقع على عاتقك مسؤولية تحديد موقع المستخدمين، ثم تعيين المعلمة View بشكل صحيح لهذا الموقع. بدلا من ذلك، لديك خيار تعيين "View=Auto"، والذي سيعيد بيانات الخريطة استنادا إلى عنوان IP للطلب. يجب استخدام المعلمة View في خرائط Azure وفقا للقوانين المعمول بها، بما في ذلك تلك المتعلقة بالتعيين، للبلد/المنطقة حيث تتوفر الخرائط والصور والبيانات الأخرى ومحتوى الجهات الخارجية المصرح لك بالوصول إليه عبر خرائط Azure. مثال: view=IN.

يرجى الرجوع إلى طرق العرض المدعومة للحصول على التفاصيل والاطلاع على طرق العرض المتوفرة.

view?: "AE" | "AR" | "BH" | "IN" | "IQ" | "JO" | "KW" | "LB" | "MA" | "OM" | "PK" | "PS" | "QA" | "SA" | "SY" | "YE" | "Auto" | "Unified"

قيمة الخاصية

"AE" | "AR" | "BH" | "IN" | "IQ" | "JO" | "KW" | "LB" | "MA" | "OM" | "PK" | "PS" | "QA" | "SA" | "SY" | "YE" | "Auto" | "Unified"

width

عرض الصورة الناتجة بالبكسل. النطاق من 1 إلى 8192. الافتراضي هو 512. لا ينبغي استخدامه مع bbox.

width?: number

قيمة الخاصية

number

zoom

مستوى التكبير/التصغير المطلوب للخريطة. يجب أن تكون قيمة التكبير/التصغير في النطاق: 0-20 (شامل). القيمة الافتراضية هي 12.

يرجى مراجعة مستويات التكبير/التصغير وشبكة التجانب للحصول على التفاصيل.

zoom?: number

قيمة الخاصية

number