ملاحظة
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
توفر هذه المقالة نظرة عامة على مواصفات كتالوج الأصول SpatioTemporal (STAC) وكيفية استخدامه من قبل Microsoft Planetary Computer Pro.
مواصفات STAC
مواصفات STAC هي معيار مفتوح يستند إلى المجتمع يجعل من السهل العثور على البيانات الجغرافية المكانية ودمجها واستخدامها. يوفر STAC بنية مشتركة لوصف وفهرسة "الأصول المكانية". وهذا يعني أنه يمكنك استخدامه لفهرسة البيانات وتنظيمها عبر كل من المساحة والوقت.
ونتيجة لذلك، تمكن STAC المؤسسات من جعل أصولها الجغرافية المكانية متاحة لمجموعة واسعة من المستخدمين. يمكن استخدام كتالوجات STAC لتنظيم العديد من أنواع بيانات الأصول الجغرافية المكانية، بما في ذلك:
- صور القمر الصناعي والجوي والطائرات بدون طيار
- بيانات LIDAR و SAR
- فيديو كامل الحركة
- بيانات فائقة الطيف
- تنسيقات البيانات المشتقة الأخرى
بالإضافة إلى ذلك، يمكن استخدام STAC مع تنسيقات البيانات الأصلية للسحابة الحالية والناشئة مثل GeoTIFFs المحسنة للسحابة (COGs) و GeoParquet.
منذ إصداره في عام 2018، سرعان ما اعتمدت العديد من المؤسسات STAC لتنظيم بياناتها المكانية. وتشمل هذه المنظمات مشغلي السواتل والوكالات الحكومية ومجموعات المجتمع المدني والشركات التجارية.
وتتألف مواصفات السلطة من أربعة معايير تكميلية لوصف الأصول الجيوفضائية، وتنظيم تلك الأصول في مجموعات، وجعل تلك الأصول قابلة للبحث عن طريق واجهات برمجة التطبيقات المشتركة. على وجه التحديد، تتضمن معايير STAC هذه ما يلي:
يستخدم Planetary Computer Pro مواصفات STAC عبر جميع جوانب إدارة البيانات.
كتالوجات STAC
مقدمة إلى GeoCatalogs
تتيح لك خدمة Planetary Computer Pro إنشاء مورد GeoCatalog في اشتراك Azure الخاص بك، لاستيعاب مجموعات البيانات الجغرافية المكانية وإدارتها والبحث فيها وتوزيعها. GeoCatalog هو مورد Azure، من منظور STAC API، يعادل منطقيا كتالوج STAC. كتالوج STAC هو كائن المستوى الأعلى في التسلسل الهرمي ل STAC الذي يجمع منطقيا مجموعات STAC وعناصر STAC. يمكنك مشاهدة كتالوج STAC JSON ل GeoCatalog معين باستخدام عارض ويب JSON بالانتقال إلى https://<your geocatalog uri>/json-api?path=/. راجع مواصفات كتالوج STAC لمعرفة المزيد حول مواصفات كتالوج STAC.
يتم تعريف GeoCatalog باستخدام المعلومات التالية:
| الحقل | الوصف |
|---|---|
| الاشتراك | اشتراك Azure حيث يتم نشر مثيل GeoCatalog |
| مجموعة الموارد | مجموعة موارد Azure حيث يتم نشر مثيل GeoCatalog |
| اسم | اسم مثيل GeoCatalog |
| المنطقة | منطقة Azure حيث يتم نشر مثيل GeoCatalog. |
حاليا، يمكن ل Planetary Computer Pro نشر GeoCatalogs في مناطق Azure التالية:
- شرق الولايات المتحدة
- وسط شمال الولايات المتحدة
- أوروبا الغربية
- وسط كندا
يمكن توفير GeoCatalog باستخدام مدخل Microsoft Azure أو واجهة برمجة تطبيقات Azure Rest. لمعرفة كيفية نشر GeoCatalog في اشتراك Azure، اقرأ إنشاء مورد GeoCatalog.
مجموعات STAC
مقدمة إلى المجموعات
يسمح لك GeoCatalog بإنشاء مجموعات لتخزين مجموعات البيانات الجغرافية المكانية وتنظيمها على Azure. يتم استخدام مجموعة STAC لوصف مجموعة من عناصر STAC التي تشترك في الخصائص وبيانات التعريف، مثل منطقة جغرافية مشتركة أو أداة استشعار. راجع مواصفات مجموعة STAC لمعرفة المزيد حول مفهوم مجموعة STAC.
تعريف المجموعة
يلتزم Planetary Computer Pro بمواصفات مجموعة STAC التي تحدد مجموعة من الحقول المشتركة لوصف مجموعة البيانات والعناصر المضمنة.
ضمن مجموعة، يمكنك تحديد نوع وبنية البيانات المخزنة في تلك المجموعة. يمكنك أيضا إضافة إعدادات تكوين العرض لتصور البيانات داخل المجموعة باستخدام Planetary Computer Pro's Explorer.
يتم تعريف المجموعات في GeoCatalog بتنسيق JSON وتتضمن الحقول التالية:
| الحقل | الوصف |
|---|---|
| المعرف | مطلوب - معرف للمجموعة الفريدة عبر الموفر. |
| النوع | مطلوب - نوع عنصر STAC؛ يجب أن تكون "مجموعة". |
| العنوان | عنوان وصفي قصير من سطر واحد للمجموعة. |
| الوصف | مطلوب - وصف تفصيلي متعدد الأسطر لشرح المجموعة بالكامل. |
| التراخيص | مطلوب - تراخيص المجموعة. |
| مدى | مطلوب - يصف النطاق المكاني (خط الطول/خط العرض) والنطاق الزمني (نطاق التاريخ) للمجموعة. |
| الموفرون | أي من المؤسسات التي تلتقط محتوى المجموعة أو تعالجه. |
| ملخصات | قائمة أزواج قيم المفاتيح التي توفر نظرة عامة على خصائص العناصر المضمنة. |
| أصول المجموعة | ملفات البيانات المقترنة مباشرة بالمجموعة، على سبيل المثال، صورة مصغرة. |
| أصول العنصر | معلومات تفصيلية حول ملفات البيانات المضمنة في عناصر المجموعة. لمزيد من المعلومات، راجع أصول العنصر. |
| الارتباطات | مطلوب - قائمة كائنات الارتباط بالموارد وعناوين URL ذات الصلة. |
| الكلمات الأساسية | قائمة الكلمات الأساسية التي تصف المجموعة. |
| إصدار STAC | مطلوب - إصدار STAC المستخدم من قبل المجموعة. |
أصول العنصر
item_assets يوفر الحقل، على مستوى المجموعة، طريقة لتحديد الأصول (ملفات البيانات) المتوفرة في أي عنصر تابع. لا تعني الأصول المدرجة في هذا الحقل أن جميع الأصول متاحة لجميع العناصر (يجب أن تكون اتحاد الأصول المتاحة، وليس تقاطع الأصول المتاحة). يتم تمكين هذا الحقل في GeoCatalog عبر ملحق item_assets لمواصفات STAC. ملحق أصول العناصر مطلوب إذا كنت تريد تصور العناصر في مستكشف GeoCatalog.
item_assets الحقل هو نفسه كائن، مع حقلين على الأقل من الحقول التالية:
| الحقل | النوع | الوصف |
|---|---|---|
| عنوان | سلسلة | العنوان المعروض للعملاء والمستخدمين. |
| وصف | سلسلة | وصف الأصل الذي يوفر المزيد من التفاصيل، مثل كيفية معالجته أو إنشائه. |
| النوع | سلسلة | نوع وسائط الأصل. |
| ادوار | قائمة السلاسل | الأدوار الدلالية للأصل، على غرار استخدام rel في الارتباطات. |
أمثلة JSON للمجموعة
يوضح المثال التالي الحد الأدنى من مجموعة JSON. لمزيد من الحقول، راجع مواصفات مجموعة STAC.
{
"id": "example-collection",
"type": "Collection",
"title": "Example collection",
"description": "An example collection",
"license": "CC-BY-4.0",
"extent": {
"spatial": {
"bbox": [
[
-180,
-90,
180,
90
]
]
},
"temporal": {
"interval": [
[
"2018-01-01T00:00:00Z",
"2018-12-31T23:59:59Z"
]
]
}
},
"links": [],
"stac_version": "1.0.0"
}
للحصول على مثال JSON أكثر تعقيدا قليلا، راجع هذا المثال الذي يصف مجموعة بيانات مفتوحة من البرنامج الوطني للصور الزراعية (NAIP).
تكوين المجموعة
من أجل تصور المجموعات في مستكشف GeoCatalog، هناك العديد من التكوينات التي يجب تعريفها، بما في ذلك:
عناصر STAC
مقدمة حول عناصر STAC
يسمح لك GeoCatalog بتخزين مجموعات البيانات الجغرافية المكانية وتنظيمها في مجموعات. عنصر STAC هو العنصر الأساسي في مجموعة GeoCatalog، ويحتوي على بيانات تعريف لمشهد وارتباطات إلى أصول من هذا المشهد (مثل صورة القمر الصناعي). تسمح بيانات التعريف الخاصة بالعنصر ل GeoCatalog بالبحث عن الأصول المكانية والاستعلام عنها. راجع مواصفات عنصر STAC لمعرفة المزيد حول عناصر STAC.
تعريف العنصر
يلتزم Planetary Computer Pro بمواصفات عنصر STAC التي تحدد مجموعة من الحقول المشتركة لوصف عنصر، مثل النطاق الزمني والأصول المتعلقة بالعنصر. يتم تعريف العناصر بتنسيق JSON ويمكن توسيعها بمرونة لتضمين المزيد من بيانات التعريف.
يتطلب عنصر STAC صالح الحقول التالية:
| الحقل | الوصف |
|---|---|
| المعرف | مطلوب - معرف العنصر الفريد عبر المجموعة الأصل للعنصر |
| النوع | مطلوب - نوع كائن GeoJSON؛ يجب أن تكون "ميزة" |
| هندسة | مطلوب - يحدد البصمة الكاملة للأصل الذي يمثله هذا العنصر كعنصر هندسي GeoJSON |
| مربع إحاطة | مطلوب - إحداثيات المربع المحيط للأصل الذي يمثله هذا العنصر |
| الخصائص | مطلوب - بيانات تعريف أخرى للعنصر |
| الأصول | مطلوب - أصول البيانات المقترنة بالعنصر، ولكل منها مفتاح فريد |
| المجموعة | مطلوب - معرف المجموعة الأصل للعنصر |
| الارتباطات | مطلوب - قائمة كائنات الارتباط بالموارد وعناوين URL ذات الصلة |
| إصدار STAC | مطلوب - إصدار STAC المستخدم من قبل العنصر |
تتضمن بيانات التعريف الشائعة للعناصر التي تتجاوز هذه الحقول المطلوبة التاريخ والوقت والتراخيص والموفرين والأداة والمزيد.
مثال JSON للعنصر
يوضح المثال التالي عنصر أساسي JSON.
{
"stac_version": "1.0.0",
"stac_extensions": [],
"type": "Feature",
"id": "20201211_223832_CS2",
"bbox": [
172.91173669923782,
1.3438851951615003,
172.95469614953714,
1.3690476620161975
],
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
172.91173669923782,
1.3438851951615003
],
[
172.95469614953714,
1.3438851951615003
],
[
172.95469614953714,
1.3690476620161975
],
[
172.91173669923782,
1.3690476620161975
],
[
172.91173669923782,
1.3438851951615003
]
]
]
},
"properties": {
"datetime": "2020-12-11T22:38:32.125000Z"
},
"collection": "simple-collection",
"links": [
{
"rel": "collection",
"href": "./collection.json",
"type": "application/json",
"title": "Simple example collection"
},
{
"rel": "root",
"href": "./collection.json",
"type": "application/json",
"title": "Simple example collection"
},
{
"rel": "parent",
"href": "./collection.json",
"type": "application/json",
"title": "Simple example collection"
}
],
"assets": {
"visual": {
"href": "[URL]",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"title": "3-Band Visual",
"roles": [
"visual"
]
},
"thumbnail": {
"href": "[URL]",
"title": "Thumbnail",
"type": "image/jpeg",
"roles": [
"thumbnail"
]
}
}
}
ملحقات STAC
حاليا، يضيف GeoCatalog تلقائيا الملحقات التالية إلى جميع المجموعات التي تم استيعابها:
يمكن أيضا استخدام ملحقات STAC على مستوى عنصر STAC. يتمتع المستخدمون بحرية إضافة أي ملحقات STAC أخرى يريدونها، ولكن GeoCatalog لا يتحقق حاليا من صحة الملحقات.
للحصول على قائمة كاملة بملحقات STAC، بما في ذلك نضج كل منها، راجع صفحة ملحقات STAC على GitHub.
واجهة برمجة تطبيقات STAC
تتوافق واجهات برمجة تطبيقات Planetary Computer Pro مع مواصفات واجهة برمجة تطبيقات STAC، ما يتيح لك البحث بسرعة وسهولة في مجموعات البيانات على نطاق بيتابايت للعثور على أصول بيانات محددة تلبي احتياجاتك. بمجرد تحديد هذه الأصول، يمكنك عرض الأصول أو تنزيلها باستخدام واجهات برمجة تطبيقات GeoCatalog.