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

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

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

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

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

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

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

• يمنح الدور 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.

ملاحظة: بناءً على حجم ملف البيانات، قد يستغرق اكتمال عملية التحميل دقائق أو حتى ساعات. إذا حدث خطأ في التحميل، ستتلقى رسالة خطأ. ولا تحاول حذف مجموعة البيانات إلى أن تعرض لك ردًا من عملية التحميل.

ملاحظة: يمكن لمربّعات الخرائط التي تم إنشاؤها باستخدام بيانات تم تحميلها باستخدام Maps Datasets API إزالة أو تبسيط البيانات الكثيفة أو المعقّدة عند مستويات تكبير/تصغير منخفضة. على سبيل المثال، عندما يصغر المستخدم للوصول إلى ولاية أو بلد (على سبيل المثال، مستوى التكبير من 5 إلى 12)، قد تبدو البيانات المتجانبة مختلفة عما هو عند تكبير مدينة أو حيّ (على سبيل المثال، مستوى التكبير من 13 إلى 18). ويحدث ذلك من أجل الحفاظ على نحيف عرض المربّعات وتحسين أدائها باستخدام المربّعات مع عارض الخرائط.

ملاحظة: إذا كان ملف البيانات كبيرًا ويحتوي على العديد من السمات التي لا تحتاج إلى تصميمها وكنت تريد تحسين أداء العرض، يمكنك تعديل الملف لإزالة السمات غير اللازمة. يؤدي تقليل عدد السمات إلى تقليل حجم مربّعات الخريطة، ما يؤدي إلى تحسين أداء العرض.

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

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

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

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

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

متطلبات GeoJSON

تتوافق حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS مع مواصفات GeoJSON الحالية. تتوافق حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS أيضًا مع ملفات GeoJSON التي تحتوي على أي من أنواع الكائنات التالية:

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

لا تتوافق حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS مع ملفات GeoJSON التي تحتوي على بيانات في نظام مرجعي إحداثي (CRS) غير WGS84.

لمزيد من المعلومات حول GeoJSON، راجِع التوافق مع RFC 7946.

متطلبات ملف KML

تتطلّب حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS المتطلبات التالية:

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

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

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

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

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

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

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

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

      في حال حدوث خطأ في عملية التحميل:

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