ServiceOptions interface

الحزمة:

azure-maps-control

الخصائص العمومية المستخدمة في جميع طلبات خدمة atlas.

Extends

Options

الخصائص

authOptions	خيارات المصادقة المستخدمة لتخصيص كيفية مصادقة عنصر تحكم الخريطة مع خدمات خرائط Azure. إذا تم تحديد خيارات المصادقة هذه، فيجب ألا يكون ServiceOptions.subscriptionKey. يوصى باستخدام الدالة atlas.setAuthenticationOptions بدلا من ذلك.
disableTelemetry	تعطيل مجموعة بيانات تتبع الاستخدام قد يتم تعيين هذا الخيار فقط عند تهيئة الخريطة. الافتراضي: خطأ (صحيح للسحابة Azure Government)
domain	المجال الذي يجب استخدامه عند طلب تجانبات الخريطة وخدمات خرائط Azure الأخرى. إذا لم يتم https تحديد البروتوكول، فيفترض. يوصى باستخدام دالة atlas.setDomain بدلا من ذلك.
enableAccessibility	تمكين ميزة إمكانية الوصول لتوفير دعم قارئ الشاشة للمستخدمين الذين يواجهون صعوبة في تصور تطبيق الويب. يتم تعيين هذه الخاصية إلى true بشكل افتراضي.
enableAccessibilityLocationFallback	قم بتمكين الاحتياطي إلى أداة الترميز الجغرافي لواجهة برمجة تطبيقات REST للكشف عن إمكانية الوصول إلى الموقع إذا فشل استخراج الموقع من بيانات المتجهات. سيؤدي تعطيل هذا الخيار إلى منع إنشاء طلبات واجهة برمجة تطبيقات الرمز الجغرافي ولكنه قد يؤدي إلى نقص معلومات الموقع لقارئات الشاشة. الافتراضي: صحيح
fadeDuration	يتحكم في مدة حركة التلاشي/التضاؤل لتضارب التسميات، بالمللي ثانية. يؤثر هذا الإعداد على جميع طبقات الرموز. لا يؤثر هذا الإعداد على مدة انتقالات التصميم في وقت التشغيل أو التلاشى المتقاطع للوحات النقطية.
localIdeographFontFamily	يحدد مجموعة خطوط CSS لتجاوز جيل الصور بشكل محلي في نطاقات 'CJK Unified Ideographs' و'Hiragana' و'Katakana' و'Hangul Syllables'. في هذه النطاقات، سيتم تجاهل إعدادات الخط من نمط الخريطة، باستثناء الكلمات الأساسية لوزن الخط (خفيفة/عادية/متوسطة/غامقة). قم بتعيين إلى خطأ، لتمكين إعدادات الخط من نمط الخريطة لنطاقات الصور الرمزية هذه. الغرض من هذا الخيار هو تجنب طلبات خادم glyph كثيف النطاق الترددي.
mapConfiguration	يحدد تكوين الخريطة مجموعة الأنماط المتوفرة للخريطة.
maxParallelImageRequests	الحد الأقصى لعدد الصور (اللوحات النقطية، النقط، الأيقونات) لتحميلها بالتوازي، مما يؤثر على الأداء في الخرائط الثقيلة النقطية. 16 بشكل افتراضي.
refreshExpiredTiles	قيمة منطقية تحدد ما إذا كان يجب إعادة تحميل الإطارات المتجانبة المتجهة والنقطية عند انتهاء صلاحيتها (استنادا إلى رأس انتهاء الصلاحية). هذا مفيد لمجموعات البيانات التي يتم تحديثها بشكل متكرر. عند التعيين إلى خطأ، سيتم تحميل كل تجانب مرة واحدة، عند الحاجة، وعدم إعادة تحميله عند انتهاء صلاحيته. الافتراضي: صحيح
sessionId	معرف جلسة العمل لتمريره مع الطلبات. يوصى باستخدام atlas.setSessionId بدلا من ذلك.
styleAPIVersion	إصدار واجهة برمجة تطبيقات النمط المستخدم عند طلب الأنماط ومجموعات الأنماط
styleDefinitionsVersion	إصدار تعريفات الأنماط لطلبه عند طلب الأنماط من styleDefinitionsPath.
subscriptionKey	مفتاح اشتراك العميل المستخدم لتخويل الطلبات. قد يتم تعيين هذا الخيار فقط عند تهيئة الخريطة. التوصية باستخدام الدالة atlas.setSubscriptionKey بدلا من ذلك
transformRequest	إذا تم تعريف transformRequest، فسيتم استدعاء لتوفير معلمات طلب مخصصة لتحميل لوحة.
validateStyle	صحيح للتحقق من صحة الأنماط قبل تطبيقها. يستغرق التحقق من الصحة وقتا كبيرا (بضع مئات مللي ثانية) لمعالجة الأنماط أثناء التحميل الأولي.
workerCount	عدد العاملين على الويب الذين تم إنشاء مثيلهم على صفحة. بشكل افتراضي، يتم تعيينه إلى نصف عدد الذاكرات الأساسية لوحدة المعالجة المركزية (محددة عند 6).

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

authOptions

خيارات المصادقة المستخدمة لتخصيص كيفية مصادقة عنصر تحكم الخريطة مع خدمات خرائط Azure. إذا تم تحديد خيارات المصادقة هذه، فيجب ألا يكون ServiceOptions.subscriptionKey. يوصى باستخدام الدالة atlas.setAuthenticationOptions بدلا من ذلك.

authOptions?: AuthenticationOptions

قيمة الخاصية

AuthenticationOptions

disableTelemetry

تعطيل مجموعة بيانات تتبع الاستخدام قد يتم تعيين هذا الخيار فقط عند تهيئة الخريطة. الافتراضي: خطأ (صحيح للسحابة Azure Government)

disableTelemetry?: boolean

قيمة الخاصية

boolean

domain

المجال الذي يجب استخدامه عند طلب تجانبات الخريطة وخدمات خرائط Azure الأخرى. إذا لم يتم https تحديد البروتوكول، فيفترض. يوصى باستخدام دالة atlas.setDomain بدلا من ذلك.

domain?: string

قيمة الخاصية

string

enableAccessibility

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

enableAccessibility?: boolean

قيمة الخاصية

boolean

enableAccessibilityLocationFallback

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

enableAccessibilityLocationFallback?: boolean

قيمة الخاصية

boolean

fadeDuration

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

fadeDuration?: number

قيمة الخاصية

number

localIdeographFontFamily

يحدد مجموعة خطوط CSS لتجاوز جيل الصور بشكل محلي في نطاقات 'CJK Unified Ideographs' و'Hiragana' و'Katakana' و'Hangul Syllables'. في هذه النطاقات، سيتم تجاهل إعدادات الخط من نمط الخريطة، باستثناء الكلمات الأساسية لوزن الخط (خفيفة/عادية/متوسطة/غامقة). قم بتعيين إلى خطأ، لتمكين إعدادات الخط من نمط الخريطة لنطاقات الصور الرمزية هذه. الغرض من هذا الخيار هو تجنب طلبات خادم glyph كثيف النطاق الترددي.

localIdeographFontFamily?: string

قيمة الخاصية

string

mapConfiguration

يحدد تكوين الخريطة مجموعة الأنماط المتوفرة للخريطة.

mapConfiguration?: string | MapConfiguration

قيمة الخاصية

string | MapConfiguration

maxParallelImageRequests

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

maxParallelImageRequests?: number

قيمة الخاصية

number

refreshExpiredTiles

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

refreshExpiredTiles?: boolean

قيمة الخاصية

boolean

sessionId

معرف جلسة العمل لتمريره مع الطلبات. يوصى باستخدام atlas.setSessionId بدلا من ذلك.

sessionId?: string

قيمة الخاصية

string

styleAPIVersion

إصدار واجهة برمجة تطبيقات النمط المستخدم عند طلب الأنماط ومجموعات الأنماط

styleAPIVersion?: string

قيمة الخاصية

string

styleDefinitionsVersion

إصدار تعريفات الأنماط لطلبه عند طلب الأنماط من styleDefinitionsPath.

styleDefinitionsVersion?: string

قيمة الخاصية

string

subscriptionKey

مفتاح اشتراك العميل المستخدم لتخويل الطلبات. قد يتم تعيين هذا الخيار فقط عند تهيئة الخريطة. التوصية باستخدام الدالة atlas.setSubscriptionKey بدلا من ذلك

subscriptionKey?: string

قيمة الخاصية

string

transformRequest

إذا تم تعريف transformRequest، فسيتم استدعاء لتوفير معلمات طلب مخصصة لتحميل لوحة.

transformRequest?: (url: string, resourceType: ResourceType) => RequestParameters

قيمة الخاصية

(url: string, resourceType: ResourceType) => RequestParameters

validateStyle

صحيح للتحقق من صحة الأنماط قبل تطبيقها. يستغرق التحقق من الصحة وقتا كبيرا (بضع مئات مللي ثانية) لمعالجة الأنماط أثناء التحميل الأولي.

validateStyle?: boolean

قيمة الخاصية

boolean

workerCount

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

workerCount?: number

قيمة الخاصية

number