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

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

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

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

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

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

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

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

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

• عند تحميل البيانات من 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.
• الحد الأقصى لحجم الملف المسموح به هو 500 ميغابايت.
• لا يمكن أن تبدأ أسماء أعمدة السمات بالسلسلة "?_".
• لا يتم دعم الأشكال الهندسية ثلاثية الأبعاد. وهذا يشمل الحرف "Z" بتنسيق WKT، وإحداثي الارتفاع بتنسيق GeoJSON.

أفضل ممارسات إعداد البيانات

في حال كانت بيانات المصدر معقدة أو كبيرة، مثل النقاط الكثيفة أو السلاسل الخطية الطويلة أو المضلّعات (تندرج غالبًا أحجام الملفات المصدر التي تزيد عن 50 ميغابايت ضمن هذه الفئة)، ننصحك بتبسيط بياناتك قبل التحميل لتحقيق أفضل أداء في الخريطة المرئية.

فيما يلي بعض أفضل الممارسات لإعداد بياناتك:

1. الحدّ من خصائص الميزات: الاحتفاظ فقط بخصائص الميزات المطلوبة لتصميم النمط خريطتك، على سبيل المثال "id" و"category". يمكنك دمج مواقع إضافية مع ميزة في أحد البرامج. المستخدم باستخدام أنماط تستند إلى البيانات على مفتاح معرّف فريد. على سبيل المثال، راجع الاطّلاع على بياناتك في الوقت الفعلي باستخدام النمط المستند إلى البيانات
2. استخدام أنواع بيانات بسيطة لعناصر المواقع، حيثما أمكن، مثل الأعداد الصحيحة لتقليل حجم المربعات وتحسين أداء الخريطة.
3. يجب تبسيط الأشكال الهندسية المعقّدة قبل تحميل ملف. يمكنك إجراء ذلك أداة جغرافية مكانية من اختيارك، مثل الأداة المفتوحة المصدر Mapshaper.org، أو في BigQuery باستخدام ST_Simplify على الأشكال الهندسية للمضلّعات المعقدة.
4. تجميع نقاط شديدة الكثافة قبل تحميل ملف يمكنك إجراء ذلك أداة جغرافية مكانية من اختيارك، مثل الأداة المفتوحة المصدر دوال مجموعات Turf.js أو في BigQuery. باستخدام ST_CLUSTERDBSCAN على الأشكال الهندسية النقطية الكثيفة.

اطّلِع على إرشادات إضافية حول أفضل ممارسات مجموعات البيانات على تمثيل بياناتك مرئيًا باستخدام مجموعات البيانات وBigQuery.

متطلبات GeoJSON

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

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

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

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

متطلبات KML

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

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

• رموز أو <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. اختَر مصدر التحميل للبيانات المستخدَمة لتعبئة مجموعة البيانات سطح المكتب، أو ملف محلي على نظامك، حزمة Google Cloud Storage:
   • في الكمبيوتر المكتبي، انقر على تصفّح ثم اختَر الملف من محدد الملفات.
   • بالنسبة إلى حزمة Google Cloud Storage، انقر على تصفّح واختَر الحزمة والملف الذي يحتوي على البيانات.
7. اختَر تنسيق الملف.
8. انقر على متابعة لمراجعة الإعدادات.

9. انقر على إنشاء. تظهر صفحة مجموعات البيانات تعرض مجموعة البيانات الأصلية. يجب أن تكون الحالة جارٍ المعالجة.

   في حال تحميل البيانات بنجاح:

   • تم ضبط حالة مجموعة البيانات على مكتملة.
   • تصبح مجموعة البيانات "نشطة" وهو الإصدار الذي يستخدمه تطبيقك.

   إذا كان هناك خطأ في عملية التحميل:

   • ويتم تعيين حالة إصدار مجموعة البيانات الجديد على حالة غير مكتمل.

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

بعد إنشاء مجموعة بيانات، يمكنك عرض مجموعة البيانات أو تعديلها:

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

   6. انقر على الزر استيراد ملف البيانات لتحميل بيانات جديدة إلى مجموعة البيانات.

      يؤدي تحميل بيانات جديدة إلى مجموعة البيانات إلى إنشاء نسخة جديدة من مجموعة البيانات. إذا لم تكن البيانات الجديدة تم التحميل بنجاح:

      • تم ضبط حالة الإصدار الجديد من مجموعة البيانات على مكتملة.
      • يصبح الإصدار الجديد هو الإصدار "النشط" وهو الإصدار الذي يستخدمه تطبيقك.

      إذا كان هناك خطأ في عملية التحميل:

      • ويتم تعيين حالة إصدار مجموعة البيانات الجديد على حالة غير مكتمل. على سبيل المثال، إذا كانت هناك قيمة "نشطة" سابقة والإصدار، حالة مجموعة البيانات على REVERTED.
      • الحالة السابقة "النشطة" إصدار مجموعة البيانات يظل "نشطًا" الإصدار وهل الإصدار الذي يستخدمه تطبيقك.