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