بعد إنشاء مجموعة بيانات وتحميل البيانات إليها، يمكنك استخدام طلبات 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