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