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

اختيار النظام الأساسي: Android iOS JavaScript

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

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

ضبط الأدوار

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

ملاحظة: إذا أنشأت المشروع، سيكون لديك دور "المالك" في المشروع. تعرض صفحة IAM في 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، في بعض اللغات، يمكن تمثيل كل حرف بعدة بايتات).
• يجب أن يكون حجم الأوصاف أقل من 1,000 بايت.

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

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

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

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

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

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

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

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

1. تقليل خصائص الميزات: احتفِظ فقط بخصائص الميزات اللازمة لتصميم خريطتك، مثل "المعرّف" و "الفئة". يمكنك ربط خصائص إضافية بميزة في تطبيق عميل باستخدام أنماط مستندة إلى البيانات على مفتاح معرّف فريد. على سبيل المثال، يمكنك الاطّلاع على الاطّلاع على بياناتك في الوقت الفعلي باستخدام "التصميم المستند إلى البيانات".
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 (Well-Known Text)
• 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 كجزء من كل تعريف لعنصر Feature وعنصر Geometry.

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

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

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

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

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

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

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

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

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

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

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

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

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

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