데이터 세트를 만들고 데이터를 업로드한 후에는 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
또는 다음 플래그를 사용하여 /tmp
의 myjson.json에 데이터를 다운로드합니다.
디렉터리:
--output /tmp/myjson.json