بعد إنشاء مجموعة بيانات وتحميل البيانات إليها، يمكنك استخدام طلبات 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
إلى
نقطة نهاية الحصول على مجموعة البيانات والتي
على معرّف مجموعة البيانات:
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 في الdirectory
نفسه المستخدَم لتشغيل الأمر cURL
:
--output myjson.json
أو استخدِم العلامة التالية لتنزيل البيانات إلى myjson.json في الدليل /tmp
:
--output /tmp/myjson.json