데이터 세트를 만들고 데이터를 업로드한 후에는 HTTP GET 요청을 사용하여 데이터 세트에 액세스할 수 있습니다. 이 페이지에서는 모든 데이터 세트를 나열하는 방법, 특정 데이터 세트에 대한 정보를 가져오는 방법, 데이터 세트에서 데이터를 다운로드하는 방법을 설명합니다.
데이터 세트 버전 정보
데이터 업로드에 성공하면 데이터 세트의 상태가 STATE_COMPLETED로 설정되고 데이터 세트가 활성 버전이 됩니다. 즉, 앱에서 데이터 세트를 사용할 준비가 된 것입니다. 데이터 세트의 state을 확인하려면 모든 데이터 세트를 나열하거나 특정 데이터 세트를 가져오면 됩니다.
데이터 세트에 새 데이터를 업로드하여 새 버전의 데이터 세트를 만들 수 있습니다.
새 데이터가 성공적으로 업로드되면 새 버전은 '활성' 버전이 되고 앱에서 사용하는 버전이 됩니다.
업로드에 오류가 있으면 이전에 성공한 데이터 세트 버전은 '활성' 버전으로 유지되며 앱에서 사용하는 버전입니다.
데이터 세트의 새 버전을 만드는 방법에 대한 자세한 내용은 데이터 세트에 새 데이터 업로드를 참조하세요.
모든 데이터 세트 나열
listdataset 엔드포인트로 HTTP GET 요청을 전송하여 모든 데이터 세트를 나열합니다.
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"
}
}
]
}
데이터 세트에 관한 정보 가져오기
특정 데이터 세트에 대한 정보를 가져오려면 데이터 세트의 ID도 포함된 get 데이터 세트 엔드포인트에 HTTP GET 요청을 보냅니다.
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"
}
}
데이터 세트 다운로드
최신 버전의 데이터 세트에서 데이터를 다운로드하려면 데이터 세트의 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