إنشاء مجموعة بيانات وإدارتها

تتيح لك مجموعات البيانات تحميل بيانات جغرافية مكانية من ملف محلي أو من Google Cloud Storage إلى "منصة خرائط Google". يمكنك بعد ذلك ربط مجموعة بيانات بنمط واحد أو أكثر من أنماط الخريطة في Cloud Console. بعد ربط مجموعة البيانات بنمط الخرائط، استخدم واجهة برمجة التطبيقات المستندة إلى البيانات لتحديد الأنماط في تطبيق الخرائط بشكل ديناميكي.

يمكنك أيضًا استخدام واجهة برمجة تطبيقات REST لتحميل بياناتك الجغرافية المكانية في مجموعة بيانات. لمزيد من المعلومات، اطّلِع على Maps Datasets API.

إعداد الأدوار

لإنشاء مجموعات بيانات وإدارتها في مشروع على Google Cloud، يجب أن يكون لديك دور المالك أو "محرّر إدارة الهوية وإمكانية الوصول" (IAM) في المشروع.

بدلاً من ذلك، يمكنك تخصيص أدوار إدارة الهوية وإمكانية الوصول التالية لحساب مستخدم أو حساب خدمة تستخدمه لإدارة مجموعات البيانات:

• يمنح الدور Maps Platform Datasets Admin إذن القراءة/الكتابة لحساب المستخدمِين أو الخدمات إلى مجموعات البيانات في المشروع. يسمح هذا الدور للمستخدم بإجراء كل العمليات على مجموعة البيانات.
• يمنح الدور Maps Platform Datasets Viewer حق الوصول للقراءة فقط إلى مجموعات البيانات في المشروع. يسمح لك هذا الدور بإجراء عملية قائمة أو الحصول عليها أو تنزيلها في مجموعة بيانات.

للحصول على مزيد من المعلومات، يُرجى الاطّلاع على منح دور إدارة الهوية وإمكانية الوصول باستخدام وحدة تحكُّم Google Cloud.

مصدر بيانات لمجموعة بيانات

بعد إنشاء مجموعة بيانات، حمِّل البيانات إلى مجموعة البيانات من Google Cloud Storage أو من ملف محلي.

• عند تحميل البيانات من Cloud Storage، حدِّد مسار الملف إلى المورد الذي يتضمّن البيانات في Cloud Storage. هذا المسار في الشكل gs://GCS_BUCKET/FILE.

  يحتاج المستخدم الذي قدّم الطلب إلى دور عارض عنصر التخزين أو أي دور آخر يتضمّن الإذن storage.objects.get. لمزيد من المعلومات حول إدارة الوصول إلى Cloud Storage، يمكنك الاطّلاع على نظرة عامة على التحكّم في الوصول.

• عند تحميل البيانات من ملف محلي، حدِّد المسار إلى ملف GeoJSON أو KML أو CSV الذي يحتوي على البيانات المطلوب تحميلها.

المتطلبات الأساسية

عند إنشاء مجموعة بيانات:

• يجب أن تكون أسماء العرض فريدة في مشروع Google Cloud.
• يجب أن تكون أسماء العرض أقل من 64 بايت (لأنه يتم تمثيل هذه الأحرف في UTF-8، وفي بعض اللغات يمكن تمثيل كل حرف بعدة بايت).
• يجب أن يكون حجم الأوصاف أقل من 1000 بايت.

عند تحميل البيانات:

• وتشمل أنواع الملفات المتوافقة CSV وGeoJSON وKML.
• الحد الأقصى لحجم الملف المتوافق هو 350 ميغابايت.
• لا يمكن أن تبدأ أسماء أعمدة السمات بالسلسلة "?_".
• الأشكال الهندسية الثلاثية الأبعاد غير متاحة. ويشمل ذلك اللاحقة "Z" بتنسيق WKT، وتنسيق الارتفاع بتنسيق GeoJSON.

متطلبات GeoJSON

تتوافق واجهة برمجة تطبيقات JavaScript في "خرائط Google" مع مواصفات GeoJSON الحالية. تدعم واجهة برمجة تطبيقات JavaScript للخرائط أيضًا ملفات GeoJSON التي تحتوي على أي من أنواع العناصر التالية:

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

لا تدعم واجهة برمجة تطبيقات JavaScript للخرائط ملفات GeoJSON التي تحتوي على بيانات في نظام مرجعي للتنسيقات (CRS) بخلاف WGS84.

ولمزيد من المعلومات حول GeoJSON، يمكنك الاطّلاع على التوافق مع معيار RFC 7946.

متطلبات KML

تحتاج واجهة برمجة تطبيقات JavaScript للخرائط إلى المتطلبات التالية:

• يجب أن تكون جميع عناوين URL محلية (أو نسبية) للملف نفسه.
• الأشكال الهندسية والنقاط والمضلعات المتوافقة
• ويتم اعتبار جميع سمات البيانات سلاسل.

لا تتوفّر ميزات KML التالية:

• الرموز أو <styleUrl> المحدّدة خارج الملف.
• روابط الشبكة، مثل <NetworkLink>
• التراكبات الأرضية، مثل <GroundOverlay>
• الأشكال الهندسية الثلاثية الأبعاد أو أي علامات ذات صلة بالارتفاع مثل <altitudeMode>
• مواصفات الكاميرا مثل <LookAt>
• الأنماط التي يتم تحديدها داخل ملف KML.

متطلبات ملف CSV

وبالنسبة إلى ملفات CSV، يتم إدراج أسماء الأعمدة المتوافقة أدناه حسب الأولوية:

• latitude، longitude
• lat، long
• x، y
• wkt (نص معروف)
• address وcity وstate وzip
• address
• عمود واحد يحتوي على جميع معلومات العناوين، مثل 1600 Amphitheatre Parkway Mountain View, CA 94043

على سبيل المثال، يحتوي الملف على أعمدة باسم x وy وwkt. نظرًا لأنّه يتم منح الأولوية للسمة x وy، كما هو محدّد من خلال ترتيب أسماء الأعمدة المتوافقة في القائمة أعلاه، يتم استخدام القيم في العمودَين x وy وتجاهل العمود wkt.

بالإضافة إلى ذلك:

• يجب أن ينتمي كل اسم عمود إلى عمود واحد. وهذا يعني أنه لا يمكنك إنشاء عمود يحمل الاسم xy ويحتوي على بيانات x وy للتنسيق. يجب أن تكون الإحداثيات x وy في أعمدة منفصلة.
• أسماء الأعمدة غير حساسة لحالة الأحرف.
• ولا يهم ترتيب أسماء الأعمدة. على سبيل المثال، إذا كان ملف CSV يحتوي على lat وlong عمود، يمكن أن يحدث بأيّ ترتيب.

التعامل مع أخطاء تحميل البيانات

عند تحميل البيانات إلى مجموعة بيانات، قد تواجه إحدى الأخطاء الشائعة الموضحة في هذا القسم.

أخطاء GeoJSON

تشمل أخطاء GeoJSON الشائعة ما يلي:

• الحقل type غير مضمَّن، أو أن type ليس سلسلة. ويجب أن يحتوي ملف بيانات GeoJSON الذي تم تحميله على حقل سلسلة باسم type كجزء من كل عنصر من سمات العناصر وتعريف العنصر الهندسي.

أخطاء KML

تشمل أخطاء KML الشائعة:

• يجب ألا يحتوي ملف البيانات على أي من ميزات KML غير المتوافقة المدرجة أعلاه، وإلا فقد يتعذّر استيراد البيانات.

أخطاء ملف CSV

تشمل أخطاء CSV الشائعة:

• بعض الأعمدة مفقودة من قيم عمود الهندسة. يجب أن تحتوي جميع الصفوف في ملف CSV على قيم غير فارغة للأعمدة الهندسية. تحتوي أعمدة الأشكال الهندسية على ما يلي:
  • latitude، longitude
  • lat، long
  • x، y
  • wkt
  • address وcity وstate وzip
  • address
  • عمود واحد يحتوي على جميع معلومات العناوين، مثل 1600 Amphitheatre Parkway Mountain View, CA 94043
• إذا كان x وy هما العمودان الهندسيان، تأكّد من أن الوحدتين وخطي العرض. تستخدم بعض مجموعات البيانات العلنية أنظمة إحداثيات مختلفة ضمن عنوانَي x وy. وإذا تم استخدام الوحدات غير الصحيحة، قد يتم استيراد مجموعة البيانات بنجاح، ولكن يمكن أن تعرض البيانات المعروضة نقاط مجموعة البيانات في مواقع غير متوقعة.

إنشاء مجموعة بيانات

لإنشاء مجموعة بيانات:

1. في Google Cloud Console، انتقِل إلى صفحة مجموعات البيانات.
2. انقر على إنشاء مجموعة بيانات.
3. أدخِل اسم مجموعة البيانات. ويجب أن يكون الاسم فريدًا بين جميع مجموعات البيانات.
4. يمكنك اختياريًا إدخال وصف مجموعة البيانات.
5. انقر على متابعة. ستظهر صفحة استيراد البيانات.
6. اختَر مصدر تحميل البيانات المستخدَمة لتعبئة مجموعة البيانات باسم Desktop، أي ملفًا محليًا على نظامك أو حزمة Google Cloud Storage.
   • بالنسبة إلى سطح المكتب، انقر على تصفّح، ثم اختر الملف من أداة اختيار الملفات.
   • بالنسبة إلى Google Cloud Storage، انقر على تصفُّح واختَر حزمة البيانات والملف الذي يحتوي على البيانات.
7. اختَر تنسيق الملف.
8. انقر على متابعة لمراجعة الإعدادات.
9. انقر على إنشاء. تظهر صفحة مجموعات البيانات التي تعرض مجموعة البيانات الجديدة. يجب أن تكون الحالة جارٍ المعالجة.
10. انتظِر إلى أن تصبح حالة مجموعة البيانات مكتملة.

عرض مجموعة بيانات أو تعديلها

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

لعرض مجموعة البيانات:

1. في Google Cloud Console، انتقِل إلى صفحة مجموعات البيانات.
2. انقر على اسم مجموعة البيانات. ستظهر صفحة تفاصيل مجموعة البيانات.
   1. انقر على علامة التبويب التفاصيل للاطّلاع على معلومات عن مجموعة البيانات. وفي علامة التبويب هذه، يمكنك أيضًا تعديل اسم مجموعة البيانات ووصفها.
   2. انقر على علامة التبويب معاينة لعرض مجموعة البيانات على خريطة.
   3. انقر على علامة التبويب بيانات الجدول للاطّلاع على مجموعة فرعية من البيانات المرتبطة بمجموعة البيانات.
   4. انقر على الزر تنزيل لتنزيل البيانات إلى ملف محلي.
   5. انقر على الزر حذف لحذف مجموعة البيانات.