نظرة عامة على واجهة برمجة التطبيقات Datasets API في "خرائط Google"

مجموعات البيانات هي حاويات للبيانات التي تريد استخدامها في تطبيقاتك على منصة "خرائط Google" كجزء من التصميم المستند إلى البيانات. تتيح لك واجهة برمجة التطبيقات Maps Datasets API إنشاء مجموعات بيانات وإدارتها باستخدام واجهة REST API.

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

يتطلّب إنشاء مجموعة بيانات خطوتَين:

  1. قدِّم طلبًا لإنشاء مجموعة البيانات.

  2. قدِّم طلبًا لتحميل البيانات إلى مجموعة البيانات من الكمبيوتر المكتبي أو Google Cloud Storage. يجب أن تكون بيانات التحميل ممثّلة بملف CSV أو GeoJSON أو KML.

لمزيد من المعلومات حول استخدام مجموعات البيانات كجزء من التصميم المستند إلى البيانات، يُرجى الاطّلاع على ما يلي:

طريقة عمل Maps Datasets API

تتضمّن Maps Datasets API الطرق التالية:

  • إنشاء مجموعة بيانات: استخدِم نقطة النهاية create لإنشاء مجموعة بيانات.

  • تحميل البيانات: استخدِم نقطة النهاية upload لتحميل البيانات إلى مجموعة البيانات.

  • إدراج مجموعات البيانات: استخدِم نقطة النهاية list لجلب قائمة بجميع مجموعات البيانات.

  • الحصول على مجموعة بيانات: استخدِم نقطة النهاية get لاسترداد معلومات حول مجموعة بيانات معيّنة.

  • الحصول على أخطاء مجموعة البيانات: استخدِم نقطة النهاية fetchDatasetErrors لاسترداد معلومات الخطأ حول مجموعة بيانات.

  • تعديل مجموعة بيانات: استخدِم نقطة النهاية patch لتعديل معلومات حول مجموعة بيانات معيّنة.

  • تنزيل مجموعة بيانات: استخدِم نقطة النهاية download لتنزيل البيانات من مجموعة بيانات.

  • حذف مجموعة البيانات: استخدِم نقطة النهاية delete لحذف مجموعة بيانات.

كيفية استخدام Maps Datasets API

1 إعداد حسابك ابدأ بإعداد مشروعك على Google Cloud واتّبِع التعليمات التي تظهر بعد ذلك.
2 إنشاء مجموعة بيانات وتحميل بياناتك راجِع مقالة إنشاء مجموعة بيانات.
3 الحصول على معلومات وحالة مجموعة البيانات راجِع القسم الحصول على مجموعة بيانات.

الخطوات التالية