تتيح لك مجموعات البيانات تحميل البيانات المكانية الجغرافية من ملف على الجهاز أو من Google Cloud Storage إلى منصة خرائط Google. يمكنك بعد ذلك ربط مجموعة بيانات بأسلوب خريطة واحد أو أكثر في وحدة تحكّم Cloud Console. بعد ربط مجموعة البيانات بأسلوب خرائط، استخدِم واجهة برمجة التطبيقات لتنسيق المستند إلى البيانات من أجل تنسيق تطبيق الخرائط بشكل ديناميكي.
يمكنك أيضًا استخدام واجهة برمجة تطبيقات REST لتحميل بياناتك الجغرافية المكانية إلى مجموعة بيانات. لمزيد من المعلومات، يُرجى الاطّلاع على Maps Datasets API.
ضبط الأدوار
لإنشاء مجموعات البيانات وإدارتها في مشروع على Google Cloud، يجب أن يكون لديك إما دور "مالك" أو "محرِّر" في إدارة الهوية وإمكانية الوصول في المشروع.
بدلاً من ذلك، يمكنك منح أدوار إدارة الهوية وإمكانية الوصول التالية لحساب مستخدم أو حساب خدمة تستخدمه لإدارة مجموعات البيانات:
- يمنح الدور
Maps Platform Datasets Admin
للمستخدم أو حساب الخدمات إذن الوصول للقراءة/الكتابة إلى مجموعات البيانات في المشروع. يتيح هذا الدور للمستخدم تنفيذ جميع العمليات على مجموعة بيانات. - يمنح الدور
Maps Platform Datasets Viewer
إذن بالقراءة فقط لمجموعات البيانات في المشروع. يتيح لك هذا الدور تنفيذ عملية listing (عرض) أو get (الحصول) أو download (تنزيل) على مجموعة بيانات.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة منح دور "إدارة الهوية وإمكانية الوصول" باستخدام وحدة تحكّم 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.
أفضل الممارسات لإعداد البيانات
إذا كانت بيانات المصدر معقّدة أو كبيرة، مثل النقاط الكثيفة أو سلاسل الخطوط الطويلة أو المضلّعات (غالبًا ما تندرج في هذه الفئة ملفات المصدر التي يزيد حجمها عن 50 ميغابايت)، ننصحك بتبسيط بياناتك قبل تحميلها لتحقيق أفضل أداء في الخريطة المرئية.
في ما يلي بعض أفضل الممارسات لإعداد بياناتك:
- تقليل سمات العناصر احتفظ فقط بسمات العناصر اللازمة لتنسيق خريطتك، مثل "id" و "category". يمكنك ربط مواقع إضافية بميزة في تطبيق العميل باستخدام الأنماط المستندة إلى البيانات في مفتاح معرّف فريد. على سبيل المثال، يمكنك الاطّلاع على مقالة الاطّلاع على بياناتك في الوقت الفعلي باستخدام ميزة "التنسيق المستنِد إلى البيانات".
- استخدِم أنواع بيانات بسيطة لعناصر المواقع الجغرافية كلما أمكن، مثل الأعداد الصحيحة، لتقليل حجم المربّع وتحسين أداء الخريطة.
- تبسيط الأشكال الهندسية المعقدة قبل تحميل ملف يمكنك إجراء ذلك في أداة جغرافية مكانية من اختيارك، مثل أداة Mapshaper.org المتاحة للاستخدام المفتوح، أو في BigQuery باستخدام دالة ST_Simplify على أشكال المضلّعات المعقّدة.
- تجميع النقاط الكثيفة جدًا قبل تحميل ملف يمكنك إجراء ذلك في أداة جغرافية مكانية من اختيارك، مثل الرمز البرمجي المفتوح المصدر وظائف مجموعات turf.js، أو في BigQuery باستخدام ST_CLUSTERDBSCAN على أشكال النقاط الكثيفة.
يمكنك الاطّلاع على إرشادات إضافية حول أفضل الممارسات المتعلّقة بمجموعات البيانات في مقالة عرض بياناتك باستخدام مجموعات البيانات وBigQuery.
متطلبات GeoJSON
تتوافق واجهة برمجة التطبيقات JavaScript لخرائط Google مع مواصفات GeoJSON الحالية. تتيح Maps JavaScript API أيضًا ملفات GeoJSON التي تحتوي على أي من أنواع العناصر التالية:
- عناصر الأشكال الهندسية كائن الهندسة هو شكل مكاني، ويُوصف بأنه ناتج عن دمج النقاط والخطوط والمضلّعات مع فتحات اختيارية.
- عناصر العناصر: يحتوي كائن العنصر على شكل هندسي بالإضافة إلى أزواج اسم/قيمة إضافية، ويكون معناها خاصًا بالتطبيق.
- مجموعات العناصر المميّزة: مجموعة العناصر هي مجموعة من عناصر العناصر.
لا تتوافق واجهة برمجة التطبيقات JavaScript API في "خرائط Google" مع ملفات GeoJSON التي تحتوي على بيانات في نظام مرجعي إحداثي (CRS) غير WGS84.
لمزيد من المعلومات عن GeoJSON، يُرجى الاطّلاع على مقالة التوافق مع RFC 7946.
متطلبات KML
تفرض واجهة برمجة التطبيقات Maps JavaScript API المتطلبات التالية:
- يجب أن تكون جميع عناوين 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
كجزء من كل تعريف لعنصر 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
. في حال استخدام وحدات غير صحيحة، قد يتم استيراد مجموعة البيانات بنجاح، ولكن يمكن أن تعرض البيانات المعروضة نقاط مجموعة البيانات في مواقع غير متوقّعة.
إنشاء مجموعة بيانات
لإنشاء مجموعة بيانات:
- في Google Cloud Console، انتقِل إلى صفحة مجموعات البيانات.
- انقر على إنشاء مجموعة بيانات.
- أدخِل اسم مجموعة البيانات. يجب أن يكون الاسم فريدًا بين جميع مجموعات البيانات.
- أدخِل وصفًا اختياريًا لمجموعة البيانات.
- انقر على متابعة. تظهر صفحة استيراد البيانات.
- اختَر مصدر التحميل للبيانات المستخدَمة في تعبئة مجموعة البيانات على النحو التالي:
جهاز الكمبيوتر المكتبي، أي ملف على جهازك، أو
حزمة Google Cloud Storage.
- بالنسبة إلى الكمبيوتر المكتبي، انقر على تصفّح ثم اختَر الملف من أداة اختيار الملفات.
- بالنسبة إلى حزمة Google Cloud Storage، انقر على تصفّح واختَر الحزمة والملف اللذين يحتويان على البيانات.
- اختَر تنسيق الملف.
- انقر على متابعة لمراجعة إعداداتك.
انقر على إنشاء. تظهر صفحة مجموعات البيانات التي تعرض مجموعة البيانات الجديدة. يجب أن تكون الحالة جارٍ المعالجة.
في حال تحميل البيانات بنجاح:
- تم ضبط حالة مجموعة البيانات على مكتملة.
- تصبح مجموعة البيانات هي الإصدار "النشط"، وهو الإصدار الذي يستخدمه تطبيقك.
إذا حدث خطأ في عملية التحميل:
- تم ضبط حالة إصدار مجموعة البيانات الجديدة على حالة غير مكتملة.
عرض مجموعة بيانات أو تعديلها
بعد إنشاء مجموعة بيانات، يمكنك عرض مجموعة البيانات أو تعديلها:
- في Google Cloud Console، انتقِل إلى صفحة مجموعات البيانات.
- انقر على اسم مجموعة البيانات. تظهر صفحة تفاصيل مجموعة البيانات.
- انقر على علامة التبويب التفاصيل للاطّلاع على معلومات عن مجموعة البيانات. في علامة التبويب هذه، يمكنك أيضًا تعديل اسم مجموعة البيانات ووصفها.
- انقر على علامة التبويب معاينة للاطّلاع على مجموعة البيانات على خريطة (مجموعات البيانات التي تتعلّق حالتها بـ مكتمل أو تم التراجع فقط).
- انقر على علامة التبويب بيانات الجدول للاطّلاع على جميع سمات مجموعة البيانات (مجموعات البيانات التي تكون حالتها مكتمل أو تم التراجع فقط). هذه هي السمات التي يمكنك استخدامها لتنسيق مجموعة البيانات على الخريطة.
- انقر على الزر تنزيل لتنزيل البيانات إلى ملف على الجهاز.
- انقر على الزر حذف لحذف مجموعة البيانات.
انقر على الزر استيراد ملف البيانات لتحميل بيانات جديدة إلى مجموعة البيانات.
يؤدي تحميل بيانات جديدة إلى مجموعة البيانات إلى إنشاء إصدار جديد منها. في حال تحميل البيانات الجديدة بنجاح:
- يتم ضبط حالة النسخة الجديدة من مجموعة البيانات على مكتملة.
- يصبح الإصدار الجديد هو الإصدار "النشط" وهو الإصدار الذي يستخدمه تطبيقك.
إذا حدث خطأ في عملية التحميل:
- تم ضبط حالة إصدار مجموعة البيانات الجديدة على حالة غير مكتملة. على سبيل المثال، إذا كان هناك إصدار "نشط" سابق، يتم ضبط حالة مجموعة البيانات على تم التراجع.
- يظلّ إصدار مجموعة البيانات "النشط" سابقًا هو الإصدار "النشط" وهو الإصدار الذي يستخدمه تطبيقك.