데이터 세트 가져오기

데이터 세트를 만들고 데이터를 업로드한 후 HTTP GET 요청을 사용하여 데이터 세트에 액세스할 수 있습니다. 이 페이지에서는 모든 데이터 세트를 나열하는 방법, 특정 데이터 세트에 대한 정보를 가져오는 방법, 데이터 세트에서 데이터를 다운로드하는 방법을 설명합니다.

모든 데이터 세트 나열

list 데이터 세트 엔드포인트에 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"
      }
    }
  ]
}

데이터 세트에 관한 정보 가져오기

특정 데이터 세트에 대한 정보를 가져오려면 데이터 세트 ID도 포함된 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"
  }
}

데이터 세트 다운로드

데이터 세트에서 데이터를 다운로드하려면 데이터 세트 ID도 포함된 데이터 세트 다운로드 엔드포인트에 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 플래그는 cURL 명령어를 실행하는 데 사용된 것과 동일한 디렉터리에 있는 myjson.json이라는 파일로 데이터 세트를 다운로드하도록 지정합니다.

--output myjson.json

또는 다음 플래그를 사용하여 /tmp 디렉터리의 myjson.json에 데이터를 다운로드합니다.

--output /tmp/myjson.json