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

هذا المنتج أو الميزة في وضع المعاينة (مرحلة ما قبل التوفّر للجمهور العام). قد يتم الحصول على دعم محدود في منتجات وميزات مرحلة ما قبل التوفّر للجمهور العام، كما أن التغييرات التي يتم إجراؤها على منتجات وميزات مرحلة ما قبل التوفّر للجمهور العام قد لا تتوافق مع الإصدارات الأخرى المتاحة للجمهور العام. تشمل البنود الخاصة بخدمة "منصة خرائط Google" "عروض مرحلة ما قبل التوفّر للجمهور العام". للحصول على مزيد من المعلومات، يمكنك الاطّلاع على أوصاف مرحلة الإطلاق.

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

يمكنك أيضًا استخدام واجهة برمجة تطبيقات REST لتحميل البيانات الجيوفضائية إلى مجموعة بيانات. للمزيد من المعلومات، يُرجى الاطّلاع على واجهة برمجة تطبيقات مجموعات البيانات في "خرائط Google".

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

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

ملاحظة: إذا أنشأت المشروع، فلديك دور "المالك" في المشروع. تعرض صفحة إدارة الهوية وإمكانية الوصول في Google Cloud Console مالكي المشروع والمحرِّرين.

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

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

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

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

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

ملاحظة: لا يمكنك تحميل البيانات إلى مجموعة البيانات إلا مرة واحدة. وهذا يعني أنّه بعد تشغيل طلب تحميل البيانات من 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 للخرائط مع مواصفات 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 يحتوي على بيانات الإحداثيَين س وص. ويجب وضع الإحداثيتَين س وص في أعمدة منفصلة.
• أسماء الأعمدة غير حساسة لحالة الأحرف.
• لا يهم ترتيب أسماء الأعمدة. على سبيل المثال، إذا كان ملف 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. اختَر مصدر التحميل للبيانات المستخدَمة لتعبئة مجموعة البيانات مثل سطح المكتب، أي ملف محلي على نظامك، أو حزمة Google Cloud Storage.
   • في أجهزة كمبيوتر مكتبي، انقر على تصفّح، ثم اختَر الملف من أداة اختيار الملفات.
   • في حزمة Google Cloud Storage، انقر على Browse (تصفُّح) واختَر الحزمة والملف اللذين يحتويان على البيانات.
7. اختَر تنسيق الملف.
8. انقر على متابعة لمراجعة إعداداتك.
9. انقر على إنشاء. ستظهر صفحة مجموعات البيانات لعرض مجموعة البيانات الجديدة. يجب أن تكون الحالة جارٍ المعالجة.
10. انتظِر إلى أن تصبح مجموعة البيانات بالحالة مكتملة.

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

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

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

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