REST Resource: projects.datasets

Kaynak: Veri kümesi

Haritalar platformu veri kümesinin temsili.

JSON gösterimi
{
  "name": string,
  "displayName": string,
  "description": string,
  "versionId": string,
  "usage": [
    enum (Usage)
  ],
  "status": {
    object (Status)
  },
  "createTime": string,
  "updateTime": string,
  "versionCreateTime": string,
  "versionDescription": string,

  // Union field data_source can be only one of the following:
  "localFileSource": {
    object (LocalFileSource)
  },
  "gcsSource": {
    object (GcsSource)
  }
  // End of list of possible types for union field data_source.
}
Alanlar
name

string

Kaynak adı, projeler/{proje}/veri kümeleri/{dataset_id}

displayName

string

Konsol kullanıcı arayüzünde gösterilen, insan tarafından okunabilir ad.

description

string

Bu veri kümesinin açıklaması.

versionId

string

Veri kümesinin sürüm kimliği.

usage[]

enum (Usage)

Bu veri kümesi için belirtilen kullanım alanları.

status

object (Status)

Yalnızca çıkış. Bu veri kümesi sürümünün durumu.

createTime

string (Timestamp format)

Yalnızca çıkış. Veri kümesinin ilk oluşturulduğu zaman.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Yalnızca çıkış. Veri kümesi meta verilerinin en son güncellenme zamanı.

RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

versionCreateTime

string (Timestamp format)

Yalnızca çıkış. Veri kümesinin bu sürümünün oluşturulduğu zaman. (Veriler veri kümesine aktarılırken oluştu)

RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

versionDescription

string

Yalnızca çıkış. Veri kümesinin bu sürümünün açıklaması. Veriler veri kümesine içe aktarılırken sağlanır.

Birlik alanı data_source. Veri kümesinin verilerinin kaynağıyla ilgili ayrıntılar. data_source yalnızca aşağıdakilerden biri olabilir:
localFileSource

object (LocalFileSource)

Tek bir yükleme için veri kümesinin yerel dosya kaynağı.

gcsSource

object (GcsSource)

Tek bir yükleme için veri kümesi olan bir Google Cloud Storage dosya kaynağı.

Kullanım

Kullanım, verilerin nasıl işleneceğini belirlemek için verilerin nerede kullanılacağını belirtir.

Sıralamalar
USAGE_UNSPECIFIED Bu veri kümesinin kullanımı ayarlanmadı.
USAGE_DATA_DRIVEN_STYLING Bu veri kümesi, veri odaklı stil için kullanılır.

LocalFileSource

Yerel dosya olduğunda veri kaynağıyla ilgili ayrıntılar.

JSON gösterimi
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
Alanlar
filename

string

Yüklenen dosyanın dosya adı ve uzantısı.

fileFormat

enum (FileFormat)

Yüklenen dosyanın biçimi.

FileFormat

Yüklenen dosyanın biçimi.

Sıralamalar
FILE_FORMAT_UNSPECIFIED Belirtilmemiş dosya biçimi.
FILE_FORMAT_GEOJSON GeoJson dosyasına göz atın.
FILE_FORMAT_KML KML dosyası'nı tıklayın.
FILE_FORMAT_CSV CSV dosyasını indirebilirsiniz.

GcsSource

Google Cloud Storage'dayken veri kaynağıyla ilgili ayrıntılar.

JSON gösterimi
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
Alanlar
inputUri

string

Kaynak veri URI'si. Örneğin, gs://my_bucket/my_object.

fileFormat

enum (FileFormat)

Google Cloud Storage nesnesinin dosya biçimi. Bu, çoğunlukla doğrulama için kullanılır.

Durum

Veri kümesi sürümünün durumu.

JSON gösterimi
{
  "state": enum (State),
  "errorMessage": string
}
Alanlar
state

enum (State)

Durum sıralaması.

errorMessage

string

Hatanın nedenini belirten hata mesajı. Veri kümesi başarısız durumda değilse boştur.

Eyalet

Veri kümesi sürümünün durum listesi. Buradaki değerler değiştirilirse durum yardımcı programı yöntemlerini güncelleyebilirsiniz.

Sıralamalar
STATE_UNSPECIFIED Bu veri kümesinin durumu ayarlanmadı.
STATE_IMPORTING Veri kümesi sürümü içe aktarılıyor.
STATE_IMPORT_SUCCEEDED Veri kümesi sürümü başarıyla içe aktarıldı.
STATE_IMPORT_FAILED Veri kümesi sürümü içe aktarılamadı.
STATE_DELETING Veri kümesi silinme sürecindedir.
STATE_DELETION_FAILED Silme işlemi başarısız oldu durumu. Bu durum, veri kümesinin silinmesinin başarısız olduğunu gösterir. Silme işlemi yeniden denenebilir.
STATE_PROCESSING İşleme durumu. Bu durum, veri kümelerinin türetilmiş veri kümeleriyle ilk eşleşmesini ve işlenmesini temsil eder.
STATE_PROCESSING_FAILED İşleme başarısız oldu durumu. Bu durum, işleme işleminin başarısız olduğunu ve hata raporlayabileceğini gösterir.
STATE_NEEDS_REVIEW İncelenmesi gerekiyor durumu. Bu durum, verilerin belirli bir kullanıma sunulup yayınlanabileceğini gösterir.
STATE_PUBLISHING Yayınlama durumu. Bu durum, yayınlamanın devam ettiğini gösterir.
STATE_PUBLISHING_FAILED Yayınlanamadı. Bu durum, yayınlamanın başarısız olduğunu gösterir. Yayınlama işlemi yeniden denenebilir.
STATE_COMPLETED Tamamlandı durumu. Bu durum, veri kümesinin özel kullanımı için uygun olduğunu gösterir.

Yöntemler

create

Belirtilen proje için yeni bir veri kümesi oluşturun.

delete

Belirtilen veri kümesini silin.

get

Veri kümesini alın.

list

Belirtilen projeye ait tüm veri kümelerini listeleyin.

patch

Veri kümesinin meta verilerini güncelleyin.