پس از ایجاد یک مجموعه داده و آپلود داده ها در آن، می توانید از درخواست های 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