مجموعات البيانات هي حاويات للبيانات التي تريد استخدامها في تطبيقاتك على "منصة خرائط Google" كجزء من التنسيق المستنِد إلى البيانات. تتيح لك Maps Datasets API إنشاء مجموعات البيانات وإدارتها باستخدام واجهة برمجة تطبيقات REST.
على سبيل المثال، باستخدام التصميم المستنِد إلى البيانات لمجموعات البيانات، يمكنك تحميل بياناتك المكانية إلى مجموعة بيانات، وتطبيق تصميم مخصّص على ميزات البيانات، وعرض ميزات البيانات هذه على الخرائط. يمكنك إنشاء رسوم بيانية للبيانات استنادًا إلى أشكال النقاط والخطوط المتعددة والمضلّعات، وجعل عناصر البيانات تستجيب لأحداث النقر.
يتطلّب إنشاء مجموعة بيانات خطوتَين:
قدِّم طلبًا لإنشاء مجموعة البيانات.
قدِّم طلبًا لتحميل البيانات إلى مجموعة البيانات من الكمبيوتر المكتبي أو Google Cloud Storage. يجب أن تكون بيانات التحميل ممثّلة في ملف CSV أو GeoJSON أو KML.
لمزيد من المعلومات عن استخدام مجموعات البيانات كجزء من التصميم المستنِد إلى البيانات، يُرجى الاطّلاع على:
- واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google"
- حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android
- حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS
آلية عمل واجهة برمجة التطبيقات Maps Datasets API
تتضمّن واجهة برمجة التطبيقات Maps Datasets API الطرق التالية:
إنشاء مجموعة بيانات: استخدِم نقطة نهاية create لإنشاء مجموعة بيانات.
تحميل البيانات: استخدِم نقطة نهاية upload لتحميل البيانات إلى مجموعة البيانات.
قائمة مجموعات البيانات: استخدِم نقطة النهاية list لعرض قائمة بجميع مجموعات البيانات.
الحصول على مجموعة البيانات: استخدِم نقطة نهاية get لاسترداد معلومات عن مجموعة بيانات معيّنة.
الحصول على أخطاء مجموعة البيانات: استخدِم نقطة نهاية fetchDatasetErrors لاسترداد معلومات الخطأ عن مجموعة بيانات.
تعديل مجموعة البيانات: استخدِم نقطة نهاية patch لتعديل معلومات عن مجموعة بيانات معيّنة.
تنزيل مجموعة البيانات: استخدِم نقطة نهاية download لتنزيل البيانات من مجموعة بيانات.
حذف مجموعة البيانات: استخدِم نقطة نهاية delete لحذف مجموعة بيانات.
كيفية استخدام واجهة برمجة التطبيقات Maps Datasets API
1 | الإعداد | ابدأ بـ إعداد مشروعك على Google Cloud وأكمِل التعليمات التالية. |
2 | إنشاء مجموعة بيانات وتحميل بياناتك | راجِع إنشاء مجموعة بيانات. |
3 | الحصول على معلومات حول مجموعة البيانات وحالتها | راجِع الحصول على مجموعة بيانات. |