بعد إنشاء مجموعة بيانات وتحميل البيانات إليها، يمكنك استخدام طلبات HTTP GET للوصول إلى مجموعة البيانات. تصف هذه الصفحة كيفية سرد جميع مجموعات البيانات الخاصة بك، وكيفية الحصول على معلومات حول مجموعة بيانات معينة، وكيفية تنزيل البيانات من مجموعة بيانات.
لمحة عن إصدارات مجموعة البيانات
بعد تحميل البيانات بنجاح، يتم ضبط حالة مجموعة البيانات على
STATE_COMPLETED
وتصبح مجموعة البيانات هذه هي الإصدار النشط. ويعني ذلك أنّ مجموعة البيانات جاهزة للاستخدام في تطبيقك. ولتحديد state
لمجموعة البيانات، يمكنك إدراج جميع مجموعات البيانات أو الحصول على مجموعة بيانات محدّدة.
يمكنك تحميل بيانات جديدة إلى مجموعة البيانات لإنشاء إصدار جديد من مجموعة البيانات:
إذا تم تحميل البيانات الجديدة بنجاح، يصبح الإصدار الجديد هو الإصدار "النشط" وهو الإصدار الذي يستخدمه تطبيقك.
إذا حدث خطأ في عملية التحميل، ستظل نسخة مجموعة البيانات الناجحة السابقة هي الإصدار "النشط" وهي الإصدار الذي يستخدمه تطبيقك.
لمعرفة المزيد من المعلومات حول إنشاء نسخة جديدة من مجموعة البيانات، يمكنك الاطّلاع على تحميل بيانات جديدة إلى مجموعة البيانات.
سرد جميع مجموعات البيانات
يمكنك إدراج جميع مجموعات البيانات عن طريق إرسال طلب HTTP GET
إلى نقطة نهاية
قائمة مجموعات البيانات:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets
يعرض هذا الطلب معلومات حول أحدث إصدار من جميع مجموعات البيانات،
بغض النظر عما إذا كان الإصدار هو الإصدار النشط. إذا أردت فقط إدراج الإصدار النشط من كل مجموعة بيانات، أضِف معلَمة طلب البحث tag=active
إلى الطلب:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets?tag=active
على سبيل المثال، تعرض هذه الاستدعاء معلومات حول أحدث إصدار من جميع مجموعات البيانات:
curl -X GET \ -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \ -H 'Authorization: Bearer $TOKEN' \ https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets
تعرض هذه المكالمة ردًا في النموذج:
{ "datasets": [ { "name": "projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46", "displayName": "My Test Dataset", "versionId": "5fb34e-1405-4ecd-8f81-31f1c07", "usage": [ "USAGE_DATA_DRIVEN_STYLING" ], "gcsSource": { "inputUri": "gs://mybucket/my.csv", "fileFormat": "FILE_FORMAT_CSV" }, "createTime": "2023-03-24T14:47:37.308977Z", "updateTime": "2023-03-24T14:48:05.053114Z", "versionCreateTime": "2023-03-24T14:48:05.053114Z", "status": { "state": "STATE_COMPLETED" } }, { "name": "projects/PROJECT_NUMBER_OR_ID/datasets/2c8ae479-96704-89c6435ca959", "displayName": "My Other Test Dataset", "versionId": "0d2e3-b9da-47cc-819f-7ac67562", "usage": [ "USAGE_DATA_DRIVEN_STYLING" ], "localFileSource": { "fileFormat": "FILE_FORMAT_CSV" }, "createTime": "2023-03-24T14:41:52.579755Z", "updateTime": "2023-03-24T14:42:56.784122Z", "versionCreateTime": "2023-03-24T14:42:56.784122Z", "status": { "state": "STATE_COMPLETED" } } ] }
الحصول على معلومات حول مجموعة بيانات
للحصول على معلومات حول مجموعة بيانات معيّنة، أرسِل طلب HTTP GET
إلى نقطة نهاية get dataset التي تتضمّن أيضًا معرّف مجموعة البيانات:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
يعرض هذا الطلب معلومات حول أحدث نسخة من مجموعة البيانات،
بغض النظر عما إذا كان الإصدار هو الإصدار النشط أم لا. إذا أردت الحصول على معلومات عن الإصدار النشط من مجموعة البيانات، عليك إلحاق العلامة @active
بالطلب:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID@active
مثلاً:
curl -X GET \ -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \ -H 'Authorization: Bearer $TOKEN' \ https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46@active
يعرض هذا الطلب ردًا في النموذج:
{ "name": "projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46", "displayName": "My Test Dataset", "versionId": "5fb34e-1405-4ecd-8f81-31f1c07", "usage": [ "USAGE_DATA_DRIVEN_STYLING" ], "gcsSource": { "inputUri": "gs://mybucket/my.csv", "fileFormat": "FILE_FORMAT_CSV" }, "createTime": "2023-03-24T14:47:37.308977Z", "updateTime": "2023-03-24T14:48:05.053114Z", "versionCreateTime": "2023-03-24T14:48:05.053114Z", "status": { "state": "STATE_COMPLETED" } }
تنزيل مجموعة بيانات
لتنزيل البيانات من أحدث نسخة من مجموعة البيانات، أرسِل طلب HTTP GET
إلى نقطة نهاية
تنزيل مجموعة البيانات
التي تتضمّن أيضًا معرّف مجموعة البيانات:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID:download?alt=media
مثلاً:
curl -X GET -L \ -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \ -H 'Authorization: Bearer $TOKEN' \ --output LOCAL_LOCATION_TO_OUTPUT \ https://mapsplatformdatasets.googleapis.com/download/v1/projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46:download?alt=media
في هذا المثال، يمكنك استخدام الخيار cURL --output
لتحديد اسم
الملف الذي يحتوي على البيانات التي تم تنزيلها. على سبيل المثال، تحدد علامة --output
التالية تنزيل مجموعة البيانات إلى ملف باسم myjson.json في
الدليل نفسه المستخدَم لتشغيل الأمر cURL
:
--output myjson.json
أو استخدِم العلامة التالية لتنزيل البيانات إلى myjson.json في دليل /tmp
:
--output /tmp/myjson.json