데이터 세트 가져오기

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

데이터 세트 버전 정보

데이터 업로드에 성공하면 데이터 세트의 상태가 다음과 같이 설정됩니다. STATE_COMPLETED에 도달하면 해당 데이터 세트가 활성 버전이 됩니다. 즉, 데이터 세트를 앱에서 사용할 수 있습니다. 데이터 세트의 state를 확인하려면 다음 안내를 따르세요. 모든 데이터 세트를 나열하거나 특정 데이터 세트를 가져올 수 있습니다.

데이터 세트에 새 데이터를 업로드하여 데이터 세트:

  • 새 데이터가 성공적으로 업로드되면 새 버전이 '활성' 상태가 됩니다. 앱에서 사용하는 버전입니다.

  • 업로드에 오류가 있는 경우 이전에 성공한 데이터 세트 버전 ‘활성 상태’로 유지됨 앱에서 사용하는 버전입니다.

데이터 세트의 새 버전을 만드는 방법에 대한 자세한 내용은 다음을 참조하세요. 데이터 세트에 새 데이터를 업로드합니다.

모든 데이터 세트 나열

다음 명령어로 HTTP GET 요청을 전송하여 모든 데이터 세트를 나열합니다. listdataset 엔드포인트:

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 요청을 데이터 세트 가져오기 엔드포인트 데이터 세트의 ID가 포함됩니다.

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이라는 이름의 파일에 cURL 명령어를 실행하는 데 사용되는 디렉터리입니다.

--output myjson.json

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

--output /tmp/myjson.json