Package google.maps.mapsplatformdatasets.v1

색인

MapsPlatformDatasets

Maps Platform Datasets API의 서비스 정의입니다.

CreateDataset

rpc CreateDataset(CreateDatasetRequest) returns (Dataset)

지정된 프로젝트의 새 데이터 세트를 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • mapsplatformdatasets.datasets.create

자세한 내용은 IAM 문서를 참조하세요.
DeleteDataset

rpc DeleteDataset(DeleteDatasetRequest) returns (Empty)

지정된 데이터 세트를 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • mapsplatformdatasets.datasets.delete

자세한 내용은 IAM 문서를 참조하세요.
DownloadDataset

rpc DownloadDataset(DownloadDatasetRequest) returns (DownloadDatasetResponse)

데이터 세트를 다운로드합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • mapsplatformdatasets.datasets.export

자세한 내용은 IAM 문서를 참조하세요.
FetchDatasetErrors

rpc FetchDatasetErrors(FetchDatasetErrorsRequest) returns (FetchDatasetErrorsResponse)

데이터 세트의 모든 오류를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
IAM 권한

dataset 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • mapsplatformdatasets.datasets.get

자세한 내용은 IAM 문서를 참조하세요.
GetDataset

rpc GetDataset(GetDatasetRequest) returns (Dataset)

데이터 세트를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • mapsplatformdatasets.datasets.get

자세한 내용은 IAM 문서를 참조하세요.
ImportDataset

rpc ImportDataset(ImportDatasetRequest) returns (ImportDatasetResponse)

데이터 세트에 대한 데이터의 새 버전을 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • mapsplatformdatasets.datasets.import

자세한 내용은 IAM 문서를 참조하세요.
ListDatasets

rpc ListDatasets(ListDatasetsRequest) returns (ListDatasetsResponse)

지정된 프로젝트의 모든 데이터 세트를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • mapsplatformdatasets.datasets.list

자세한 내용은 IAM 문서를 참조하세요.
UpdateDatasetMetadata

rpc UpdateDatasetMetadata(UpdateDatasetMetadataRequest) returns (Dataset)

데이터 세트의 메타데이터를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • mapsplatformdatasets.datasets.update

자세한 내용은 IAM 문서를 참조하세요.

CreateDatasetRequest

지도 데이터 세트 만들기 요청입니다.

필드
parent

string

필수 항목입니다. 데이터 세트를 소유할 상위 프로젝트입니다. 형식: projects/{project}
dataset

Dataset

필수 항목입니다. 만들 데이터 세트 버전입니다.

데이터 세트

데이터 세트 리소스를 나타냅니다.

필드
name

string

리소스 이름입니다. 형식: projects/{project}/datasets/{dataset_id}
display_name

string

콘솔 UI에 표시되는 인간이 읽을 수 있는 이름입니다.

프로젝트 내에서 고유해야 합니다.
description

string

이 데이터 세트의 설명입니다.
version_id

string

데이터 세트의 버전 ID입니다.
usage[]

Usage

이 데이터 세트의 지정된 사용 사례입니다.
status

Status

출력 전용입니다. 이 데이터 세트 버전의 상태입니다.
create_time

Timestamp

출력 전용입니다. 데이터 세트가 처음 생성된 시간입니다.
update_time

Timestamp

출력 전용입니다. 데이터 세트 메타데이터가 마지막으로 업데이트된 시간입니다.
version_create_time

Timestamp

출력 전용입니다. 이 버전이 생성된 시간입니다.
version_description

string

출력 전용입니다. 이 버전의 데이터 세트에 대한 설명입니다. 데이터 세트로 데이터를 가져올 때 제공됩니다.
통합 필드 data_source. 데이터 세트의 데이터 소스에 대한 세부정보입니다. data_source은 다음 중 하나여야 합니다.
local_file_source

LocalFileSource

단일 업로드를 위한 데이터 세트의 로컬 파일 소스입니다.
gcs_source

GcsSource

단일 업로드를 위한 데이터 세트의 Google Cloud Storage 파일 소스입니다.

DeleteDatasetRequest

데이터 세트 삭제 요청입니다.

필드
name

string

필수 항목입니다. 삭제할 데이터 세트의 이름입니다. 형식: projects/{project}/datasets/{dataset_id}

DownloadDatasetRequest

데이터 세트 다운로드 요청입니다.

필드
name

string

가져올 데이터 세트의 리소스 이름입니다. 형식: projects/{project}/datasets/{dataset_id}

DownloadDatasetResponse

DownloadDataset의 응답 객체입니다.

FetchDatasetErrorsRequest

데이터 세트에 속한 자세한 오류를 나열하는 요청입니다.

필드
dataset

string

필수 항목입니다. 모든 오류를 나열할 데이터 세트의 이름입니다. 형식: projects/{project}/datasets/{dataset_id}
page_size

int32

페이지당 반환할 최대 오류 수입니다.

최댓값은 500입니다. 500을 초과하는 값은 500으로 제한됩니다.

지정하지 않으면 최대 50개의 오류가 반환됩니다.
page_token

string

이전 ListDatasetErrors 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

FetchDatasetErrorsResponse

FetchDatasetErrors의 응답 객체입니다.

필드
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다.

이 필드를 생략하면 후속 페이지가 표시되지 않습니다.
errors[]

Status

데이터 세트와 관련된 오류입니다.

FileFormat

업로드되는 파일의 형식입니다.

열거형
FILE_FORMAT_UNSPECIFIED 지정되지 않은 파일 형식입니다.
FILE_FORMAT_GEOJSON GeoJson 파일입니다.
FILE_FORMAT_KML KML 파일.
FILE_FORMAT_CSV CSV 파일로 다운로드할 수 있습니다.

GcsSource

Google Cloud Storage에 있는 데이터 소스에 대한 세부정보입니다.

필드
input_uri

string

소스 데이터 URI 예를 들면 gs://my_bucket/my_object입니다.
file_format

FileFormat

Google Cloud Storage 객체의 파일 형식입니다. 주로 유효성 검사에 사용됩니다.

GetDatasetRequest

지정된 데이터 세트 가져오기 요청입니다.

필드
name

string

필수 항목입니다. 리소스 이름입니다. 형식: projects/{project}/datasets/{dataset_id}

'@' 기호를 추가하여 일부 특별 버전을 가져올 수도 있습니다. 태그가 있습니다. 형식: projects/{project}/datasets/{dataset_id}@{tag}

'활성' 태그: 완료된 최신 버전의 정보가 포함되며 데이터 세트에 정보가 없는 경우 NOT_FOUND가 포함됩니다.

ImportDatasetRequest

데이터 세트의 새 버전을 가져오기 위한 요청입니다.

필드
name

string

필수 항목입니다. 리소스 이름입니다. 형식: projects/{project}/datasets/{dataset_id}
version_description

string

가져오는 새 데이터에 대한 설명입니다.
통합 필드 data_source. 데이터 세트의 데이터 소스에 대한 세부정보입니다. data_source은 다음 중 하나여야 합니다.
local_file_source

LocalFileSource

일회성 가져오기를 위한 데이터 세트의 로컬 파일 소스
gcs_source

GcsSource

일회성 가져오기를 위한 데이터 세트의 Google Cloud Storage 파일 소스

ImportDatasetResponse

ImportDataset의 응답 객체입니다.

필드
name

string

필수 항목입니다. 새로 만든 데이터 세트 버전의 리소스 이름입니다. 형식: projects/{project}/datasets/{dataset_id}@{version_id}

ListDatasetsRequest

프로젝트의 데이터 세트 나열 요청입니다.

필드
parent

string

필수 항목입니다. 모든 데이터 세트를 나열할 프로젝트의 이름입니다. 형식: projects/{project}
page_size

int32

페이지당 반환할 최대 데이터 세트 수입니다.

지정하지 않거나 0이면 모든 데이터 세트가 반환됩니다.
page_token

string

이전 ListDatasets 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.
tag

string

각 데이터 세트에 대해 원하는 버전을 지정하는 태그입니다.

페이지로 나누기도 지정되면 페이지로 나누기 이후에 일부 필터링이 발생할 수 있으며, 이로 인해 마지막 페이지가 아니더라도 응답에 페이지 크기보다 적은 데이터 세트가 포함될 수 있습니다.

'active' 태그: 응답의 각 데이터 세트에는 마지막으로 완료된 버전의 정보가 포함되며 데이터 세트가 없으면 데이터 세트를 건너뜁니다.

ListDatasetsResponse

ListDatasets의 응답 객체입니다.

필드
datasets[]

Dataset

프로젝트의 모든 데이터 세트입니다.
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다.

이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

LocalFileSource

로컬 파일인 경우 데이터 소스에 대한 세부정보입니다.

필드
filename

string

업로드된 파일의 이름입니다.
file_format

FileFormat

업로드되는 파일의 형식입니다.

상태

데이터 세트의 상태입니다.

필드
state

State

상태에 대한 상태 enum입니다.
error_message

string

실패 이유를 나타내는 오류 메시지 데이터 세트가 실패 상태가 아닌 경우 비어 있습니다.

주

데이터 세트의 상태 목록입니다.

열거형
STATE_UNSPECIFIED 이 데이터 세트의 상태가 설정되지 않았습니다.
STATE_IMPORTING 데이터 세트로 데이터를 가져오는 중입니다.
STATE_IMPORT_SUCCEEDED 데이터 세트로 데이터를 가져왔습니다.
STATE_IMPORT_FAILED 데이터 세트로 데이터를 가져올 수 없습니다.
STATE_DELETING 데이터 세트를 삭제하는 중입니다.
STATE_DELETION_FAILED 삭제 실패 상태입니다. 이 상태는 데이터 세트 삭제가 실패했음을 나타냅니다. 삭제를 다시 시도할 수 있습니다.
STATE_PROCESSING 데이터를 처리하는 중입니다.
STATE_PROCESSING_FAILED 처리 실패 상태입니다. 이 상태는 처리에 실패했으며 오류가 보고될 수 있음을 나타냅니다.
STATE_NEEDS_REVIEW 이 상태는 현재 사용되지 않습니다.
STATE_PUBLISHING 게시 상태입니다. 이 상태는 게시가 진행 중임을 나타냅니다.
STATE_PUBLISHING_FAILED 게시 실패 상태입니다. 이 상태는 게시에 실패했음을 나타냅니다. 게시를 다시 시도할 수 있습니다.
STATE_COMPLETED 완료된 상태입니다. 이 상태는 데이터 세트를 특정 용도로 사용할 수 있음을 나타냅니다.

UpdateDatasetMetadataRequest

데이터 세트의 메타데이터 필드 업데이트 요청입니다.

필드
dataset

Dataset

필수 항목입니다. 업데이트할 데이터 세트의 리소스 이름입니다. 형식: projects/{project}/datasets/{dataset_id}
update_mask

FieldMask

업데이트할 필드 목록입니다.

'*' 값 전체 교체에 사용됩니다 (기본값).

사용

용도는 데이터 처리 방법을 알리기 위해 데이터가 사용되는 위치를 지정합니다.

열거형
USAGE_UNSPECIFIED 이 데이터 세트의 사용량이 설정되지 않았습니다.
USAGE_DATA_DRIVEN_STYLING 이 데이터 세트는 데이터 기반 스타일 지정에 사용됩니다.