DataSource class
فئة مصدر بيانات تسهل إدارة بيانات الأشكال التي سيتم عرضها على الخريطة. يجب إضافة مصدر بيانات إلى طبقة قبل أن يكون مرئيا على الخريطة. يمكن استخدام فئة DataSource مع SymbolLayer وLineLayer و PolygonLayer وPplyer و HeatMapLayer.
- Extends
المنشئون
Data |
فئة مصدر بيانات تسهل إدارة بيانات الأشكال التي سيتم عرضها على الخريطة.
يجب إضافة مصدر بيانات إلى طبقة قبل أن يكون مرئيا على الخريطة.
|
الأساليب
add(Feature |
إضافة أشكال إلى مصدر البيانات. سيتم تضمين كائنات GeoJSON داخل فئة شكل لتسهيل إدارتها. حدد فهرسا اختياريا لإدراج الميزة بين الأشكال/الميزات الأخرى في الطبقات. |
clear() | إزالة كافة البيانات في مصدر البيانات. |
dispose() | تنظيف أي موارد يستهلكها هذا الكائن. |
get |
استرداد العناصر الفرعية للمجموعة المحددة في مستوى التكبير/التصغير التالي. قد يكون هذا مزيجا من الأشكال والمجموعات الفرعية. ستكون المجموعات الفرعية ميزات مع خصائص مطابقة ClusteredProperties. |
get |
يحسب مستوى التكبير/التصغير الذي ستبدأ فيه المجموعة في التوسع أو الانفصال. |
get |
استرداد الأشكال الموجودة داخل نظام المجموعة. |
get |
يحصل على الخيارات المستخدمة من قبل مصدر البيانات. |
get |
استرداد شكل بالمعرف المحدد. إذا لم يتم تضمين أي شكل بالمعرف المحدد في مصدر البيانات، فسيتم إرجاع null. |
get |
إرجاع كافة الأشكال الموجودة في DataSource. |
import |
تنزيل مستند GeoJSON واستيراد بياناته إلى مصدر البيانات. يجب أن يكون مستند GeoJSON على نفس المجال أو يمكن الوصول إليه باستخدام CORS. |
remove(number | string | Shape | Feature<atlas. |
إزالة شكل واحد أو أكثر من مصدر البيانات. إذا تم تمرير سلسلة، فمن المفترض أن تكون معرفا. إذا تم تمرير رقم، يزيل الشكل في هذا الفهرس. |
remove |
إزالة شكل واحد أو أكثر من مصدر البيانات استنادا إلى معرفه. |
set |
تعيين خيارات مصدر البيانات. سيحتفظ مصدر البيانات بقيمه الحالية لأي خيار غير محدد في الخيارات المتوفرة. |
set |
الكتابة فوق كافة الأشكال في مصدر البيانات باستخدام صفيف الأشكال الجديد. |
to |
إرجاع GeoJSON FeatureCollection الذي يحتوي على جميع بيانات الشكل الموجودة في مصدر البيانات. |
الأساليب المتوارثة
get |
الحصول على معرف مصدر البيانات |
تفاصيل المنشئ
DataSource(string, DataSourceOptions)
فئة مصدر بيانات تسهل إدارة بيانات الأشكال التي سيتم عرضها على الخريطة.
يجب إضافة مصدر بيانات إلى طبقة قبل أن يكون مرئيا على الخريطة.
DataSource
يمكن استخدام الفئة مع SymbolLayer
وLineLayer
PolygonLayer
BubbleLayer
.HeatMapLayer
new DataSource(id?: string, options?: DataSourceOptions)
المعلمات
- id
-
string
معرف فريد يعينه المستخدم لمصدر البيانات. إذا لم يتم تحديد ذلك، فسيتم تعيين معرف لمصدر البيانات تلقائيا.
- options
- DataSourceOptions
خيارات مصدر البيانات.
تفاصيل الأسلوب
add(FeatureCollection | Feature<atlas.data.Geometry, any> | atlas.data.Geometry | GeometryCollection | Shape | Array<Feature<atlas.data.Geometry, any> | atlas.data.Geometry | Shape>, number)
إضافة أشكال إلى مصدر البيانات. سيتم تضمين كائنات GeoJSON داخل فئة شكل لتسهيل إدارتها. حدد فهرسا اختياريا لإدراج الميزة بين الأشكال/الميزات الأخرى في الطبقات.
function add(data: FeatureCollection | Feature<atlas.data.Geometry, any> | atlas.data.Geometry | GeometryCollection | Shape | Array<Feature<atlas.data.Geometry, any> | atlas.data.Geometry | Shape>, index?: number)
المعلمات
- data
-
FeatureCollection | Feature<Geometry, any> | Geometry | GeometryCollection | Shape | Array<Feature<Geometry, any> | Geometry | Shape>
- index
-
number
clear()
إزالة كافة البيانات في مصدر البيانات.
function clear()
dispose()
تنظيف أي موارد يستهلكها هذا الكائن.
function dispose()
getClusterChildren(number)
استرداد العناصر الفرعية للمجموعة المحددة في مستوى التكبير/التصغير التالي. قد يكون هذا مزيجا من الأشكال والمجموعات الفرعية. ستكون المجموعات الفرعية ميزات مع خصائص مطابقة ClusteredProperties.
function getClusterChildren(clusterId: number): Promise<Array<Feature<atlas.data.Geometry, ClusteredProperties | any> | Shape>>
المعلمات
- clusterId
-
number
المرتجعات
Promise<Array<Feature<Geometry, ClusteredProperties | any> | Shape>>
getClusterExpansionZoom(number)
يحسب مستوى التكبير/التصغير الذي ستبدأ فيه المجموعة في التوسع أو الانفصال.
function getClusterExpansionZoom(clusterId: number): Promise<number>
المعلمات
- clusterId
-
number
المرتجعات
Promise<number>
getClusterLeaves(number, number, number)
استرداد الأشكال الموجودة داخل نظام المجموعة.
function getClusterLeaves(clusterId: number, limit: number, offset: number): Promise<Array<Feature<atlas.data.Geometry, any> | Shape>>
المعلمات
- clusterId
-
number
- limit
-
number
الحد الأقصى لعدد الميزات التي يجب إرجاعها. اضبط على Infinity لإرجاع جميع الأشكال.
- offset
-
number
عدد الأشكال المراد تخطيها. يسمح لك بالصفحة عبر الأشكال في نظام المجموعة.
المرتجعات
getOptions()
يحصل على الخيارات المستخدمة من قبل مصدر البيانات.
function getOptions(): DataSourceOptions
المرتجعات
getShapeById(string | number)
استرداد شكل بالمعرف المحدد. إذا لم يتم تضمين أي شكل بالمعرف المحدد في مصدر البيانات، فسيتم إرجاع null.
function getShapeById(id: string | number): Shape
المعلمات
- id
-
string | number
معرف الشكل المراد إرجاعه.
المرتجعات
getShapes()
importDataFromUrl(string)
تنزيل مستند GeoJSON واستيراد بياناته إلى مصدر البيانات. يجب أن يكون مستند GeoJSON على نفس المجال أو يمكن الوصول إليه باستخدام CORS.
function importDataFromUrl(url: string): Promise<void>
المعلمات
- url
-
string
المرتجعات
Promise<void>
remove(number | string | Shape | Feature<atlas.data.Geometry, any> | Array<number | string | Shape | Feature<atlas.data.Geometry, any>>)
إزالة شكل واحد أو أكثر من مصدر البيانات. إذا تم تمرير سلسلة، فمن المفترض أن تكون معرفا. إذا تم تمرير رقم، يزيل الشكل في هذا الفهرس.
function remove(shape: number | string | Shape | Feature<atlas.data.Geometry, any> | Array<number | string | Shape | Feature<atlas.data.Geometry, any>>)
المعلمات
removeById(number | string | Array<number | string>)
إزالة شكل واحد أو أكثر من مصدر البيانات استنادا إلى معرفه.
function removeById(id: number | string | Array<number | string>)
المعلمات
- id
-
number | string | Array<number | string>
setOptions(DataSourceOptions)
تعيين خيارات مصدر البيانات. سيحتفظ مصدر البيانات بقيمه الحالية لأي خيار غير محدد في الخيارات المتوفرة.
function setOptions(options: DataSourceOptions)
المعلمات
- options
- DataSourceOptions
تعيين DataSourceOptions
setShapes(FeatureCollection | Array<Feature<atlas.data.Geometry, any> | atlas.data.Geometry | Shape>)
الكتابة فوق كافة الأشكال في مصدر البيانات باستخدام صفيف الأشكال الجديد.
function setShapes(shape: FeatureCollection | Array<Feature<atlas.data.Geometry, any> | atlas.data.Geometry | Shape>)
المعلمات
- shape
-
FeatureCollection | Array<Feature<Geometry, any> | Geometry | Shape>
الأشكال الجديدة المراد تحديثها
toJson()
إرجاع GeoJSON FeatureCollection الذي يحتوي على جميع بيانات الشكل الموجودة في مصدر البيانات.
function toJson(): FeatureCollection