بعد إنشاء مجموعة بيانات وتحميل البيانات إليها، يمكنك استخدام طلبات HTTP GET للوصول إلى مجموعة البيانات. تصف هذه الصفحة كيفية سرد جميع مجموعات البيانات لديك، وكيفية الحصول على معلومات حول مجموعة بيانات معينة، وكيفية تنزيل البيانات من مجموعة بيانات.
سرد جميع مجموعات البيانات
إدراج جميع مجموعات البيانات عن طريق إرسال طلب HTTP GET
إلى نقطة نهاية إدراج مجموعات البيانات:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets
مثال:
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
مثال:
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
يعرض هذا الطلب ردًا بالنموذج:
{ "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