Veri kümesi alma

Veri kümesi oluşturup veri yükledikten sonra veri kümesine erişmek için HTTP GET isteklerini kullanabilirsiniz. Bu sayfada, tüm veri kümelerinizi nasıl listeleyeceğiniz, belirli bir veri kümesi hakkında nasıl bilgi alacağınız ve bir veri kümesindeki verileri nasıl indireceğiniz açıklanmaktadır.

Veri kümesi sürümleri hakkında

Veriler başarıyla yüklendikten sonra veri kümesinin durumu STATE_COMPLETED olarak ayarlanır ve bu veri kümesi etkin sürüm olur. Bu, veri kümesinin uygulamanızda kullanıma hazır olduğu anlamına gelir. Veri kümesinin state değerini belirlemek için tüm veri kümelerini listeleyebilir veya belirli bir veri kümesini alabilirsiniz.

Veri kümesinin yeni bir sürümünü oluşturmak için veri kümesine yeni veriler yükleyebilirsiniz:

  • Yeni veriler başarıyla yüklenirse yeni sürüm "etkin" sürüm olur ve uygulamanız tarafından kullanılır.

  • Yükleme sırasında hata oluşursa önceki başarılı veri kümesi sürümü "etkin" sürüm olarak kalır ve uygulamanız tarafından kullanılan sürüm olur.

Veri kümesinin yeni bir sürümünü oluşturma hakkında daha fazla bilgi için Veri kümesine yeni veri yükleme başlıklı makaleyi inceleyin.

Tüm veri kümelerini listeleme

Veri kümelerini listeleme uç noktasına bir HTTP GET isteği göndererek tüm veri kümelerini listeleyin:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets

Bu istek, etkin sürüm olup olmadığına bakılmaksızın tüm veri kümelerinin en yeni sürümü hakkında bilgi döndürür. Yalnızca her veri kümesinin etkin sürümünü listelemek istiyorsanız isteğe tag=active sorgu parametresini ekleyin:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets?tag=active

Örneğin, bu çağrı tüm veri kümelerinin en yeni sürümüyle ilgili bilgileri döndürür:

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"

Bu çağrı, aşağıdaki biçimde bir yanıt döndürür:

{
  "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"
      }
    }
  ]
}

Veri kümesi hakkında bilgi edinme

Belirli bir veri kümesi hakkında bilgi edinmek için get dataset uç noktasına, veri kümesinin kimliğini de içeren bir HTTP GET isteği gönderin:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

Bu istek, etkin sürüm olup olmadığına bakılmaksızın veri kümesinin en yeni sürümü hakkında bilgi döndürür. Veri kümesinin etkin sürümü hakkında bilgi edinmek istiyorsanız isteğe @active etiketini ekleyin:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID@active

Örneğin:

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"

Bu istek, şu biçimde bir yanıt döndürür:

{
  "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"
  }
}

Veri kümesi indirme

Bir veri kümesinin en yeni sürümündeki verileri indirmek için veri kümesinin kimliğini de içeren download dataset uç noktasına bir HTTP GET isteği gönderin:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID:download?alt=media

Örneğin:

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"

Bu örnekte, indirilen verileri içeren dosyanın adını belirtmek için cURL --output seçeneğini kullanırsınız. Örneğin, aşağıdaki --output işareti, veri kümesinin cURL komutunu çalıştırmak için kullanılan dizinde myjson.json adlı bir dosyaya indirilmesini belirtir:

--output myjson.json

Dilerseniz verileri /tmp dizinindeki myjson.json dosyasına indirmek için aşağıdaki işareti kullanabilirsiniz:

--output /tmp/myjson.json