Package google.maps.mapsplatformdatasets.v1alpha

색인

MapsPlatformDatasetsV1Alpha

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 문서를 참조하세요.

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 문서를 참조하세요.

ListDatasetErrors

rpc ListDatasetErrors(ListDatasetErrorsRequest) returns (ListDatasetErrorsResponse)

데이터 세트의 모든 오류를 가져옵니다 (현재 DDS 사용 사례에만 작동).

승인 범위

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

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

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

  • mapsplatformdatasets.datasets.get

자세한 내용은 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

데이터 세트 다운로드의 응답입니다.

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}

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

새 버전의 데이터 세트를 가져온 후의 응답입니다.

필드
name

string

필수입니다. 새로 생성된 데이터 세트 버전의 리소스 이름입니다(projects/{project}/datasets/{dataset_id}@{version_id}).

ListDatasetErrorsRequest

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

필드
name

string

필수입니다. 형식: projects/${project}/datasets/{dataset_id}

page_size

int32

페이지당 반환할 최대 버전 수입니다. 기본값은 10입니다.

page_token

string

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

ListDatasetErrorsResponse

ListDatasetErrors의 응답입니다. 오류 메시지에 대해 반복되는 문자열을 반환합니다.

필드
error_messages[]

string

데이터 세트에 속하는 오류입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListDatasetsRequest

프로젝트의 데이터 세트를 나열하도록 요청합니다.

필드
parent

string

필수입니다. 모든 데이터 세트를 나열할 프로젝트의 이름입니다.

page_size

int32

페이지당 반환할 최대 버전 수입니다. 지정하지 않거나 0으로 설정하면 모든 데이터 세트가 반환됩니다.

page_token

string

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

ListDatasetsResponse

프로젝트의 데이터 세트를 나열하는 응답입니다.

필드
datasets[]

Dataset

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

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

LocalFileSource

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

필드
filename

string

업로드된 파일의 파일 이름과 확장자입니다.

file_format

FileFormat

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

상태

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

필드
state

State

상태의 상태 열거형입니다.

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 이 데이터 세트는 데이터 기반 스타일 지정에 사용됩니다.