ServiceOptions interface
الخصائص العمومية المستخدمة في جميع طلبات خدمة atlas.
- Extends
الخصائص
auth |
خيارات المصادقة المستخدمة لتخصيص كيفية مصادقة عنصر تحكم الخريطة مع خدمات خرائط Azure. إذا تم تحديد خيارات المصادقة هذه، فيجب ألا يكون ServiceOptions.subscriptionKey. يوصى باستخدام الدالة atlas.setAuthenticationOptions بدلا من ذلك. |
disable |
تعطيل مجموعة بيانات تتبع الاستخدام قد يتم تعيين هذا الخيار فقط عند تهيئة الخريطة. الافتراضي: خطأ (صحيح للسحابة Azure Government) |
domain | المجال الذي يجب استخدامه عند طلب تجانبات الخريطة وخدمات خرائط Azure الأخرى.
إذا لم يتم |
enable |
تمكين ميزة إمكانية الوصول لتوفير دعم قارئ الشاشة للمستخدمين الذين يواجهون صعوبة في تصور تطبيق الويب. يتم تعيين هذه الخاصية إلى true بشكل افتراضي. |
enable |
قم بتمكين الاحتياطي إلى أداة الترميز الجغرافي لواجهة برمجة تطبيقات REST للكشف عن إمكانية الوصول إلى الموقع إذا فشل استخراج الموقع من بيانات المتجهات. سيؤدي تعطيل هذا الخيار إلى منع إنشاء طلبات واجهة برمجة تطبيقات الرمز الجغرافي ولكنه قد يؤدي إلى نقص معلومات الموقع لقارئات الشاشة. الافتراضي: صحيح |
fade |
يتحكم في مدة حركة التلاشي/التضاؤل لتضارب التسميات، بالمللي ثانية. يؤثر هذا الإعداد على جميع طبقات الرموز. لا يؤثر هذا الإعداد على مدة انتقالات التصميم في وقت التشغيل أو التلاشى المتقاطع للوحات النقطية. |
local |
يحدد مجموعة خطوط CSS لتجاوز جيل الصور بشكل محلي في نطاقات 'CJK Unified Ideographs' و'Hiragana' و'Katakana' و'Hangul Syllables'. في هذه النطاقات، سيتم تجاهل إعدادات الخط من نمط الخريطة، باستثناء الكلمات الأساسية لوزن الخط (خفيفة/عادية/متوسطة/غامقة). قم بتعيين إلى خطأ، لتمكين إعدادات الخط من نمط الخريطة لنطاقات الصور الرمزية هذه. الغرض من هذا الخيار هو تجنب طلبات خادم glyph كثيف النطاق الترددي. |
map |
يحدد تكوين الخريطة مجموعة الأنماط المتوفرة للخريطة. |
max |
الحد الأقصى لعدد الصور (اللوحات النقطية، النقط، الأيقونات) لتحميلها بالتوازي، مما يؤثر على الأداء في الخرائط الثقيلة النقطية. 16 بشكل افتراضي. |
refresh |
قيمة منطقية تحدد ما إذا كان يجب إعادة تحميل الإطارات المتجانبة المتجهة والنقطية عند انتهاء صلاحيتها (استنادا إلى رأس انتهاء الصلاحية). هذا مفيد لمجموعات البيانات التي يتم تحديثها بشكل متكرر. عند التعيين إلى خطأ، سيتم تحميل كل تجانب مرة واحدة، عند الحاجة، وعدم إعادة تحميله عند انتهاء صلاحيته. الافتراضي: صحيح |
session |
معرف جلسة العمل لتمريره مع الطلبات. يوصى باستخدام atlas.setSessionId بدلا من ذلك. |
style |
إصدار واجهة برمجة تطبيقات النمط المستخدم عند طلب الأنماط ومجموعات الأنماط |
style |
إصدار تعريفات الأنماط لطلبه عند طلب الأنماط من styleDefinitionsPath. |
subscription |
مفتاح اشتراك العميل المستخدم لتخويل الطلبات. قد يتم تعيين هذا الخيار فقط عند تهيئة الخريطة. التوصية باستخدام الدالة atlas.setSubscriptionKey بدلا من ذلك |
transform |
إذا تم تعريف transformRequest، فسيتم استدعاء لتوفير معلمات طلب مخصصة لتحميل لوحة. |
validate |
صحيح للتحقق من صحة الأنماط قبل تطبيقها. يستغرق التحقق من الصحة وقتا كبيرا (بضع مئات مللي ثانية) لمعالجة الأنماط أثناء التحميل الأولي. |
worker |
عدد العاملين على الويب الذين تم إنشاء مثيلهم على صفحة. بشكل افتراضي، يتم تعيينه إلى نصف عدد الذاكرات الأساسية لوحدة المعالجة المركزية (محددة عند 6). |
تفاصيل الخاصية
authOptions
خيارات المصادقة المستخدمة لتخصيص كيفية مصادقة عنصر تحكم الخريطة مع خدمات خرائط Azure. إذا تم تحديد خيارات المصادقة هذه، فيجب ألا يكون ServiceOptions.subscriptionKey. يوصى باستخدام الدالة atlas.setAuthenticationOptions بدلا من ذلك.
authOptions?: 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