Veri kümesi alma

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

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

Başarılı bir veri yükleme işleminden sonra, veri kümesinin durumu STATE_COMPLETED olarak ayarlanır ve bu veri kümesi etkin sürüm haline gelir. Bu, veri kümesinin uygulamanızda kullanılmaya 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ümesi 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 haline gelir ve uygulamanız tarafından kullanılan sürüm olur.

• 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ın kullandığı sürüm olarak kalır.

Veri kümesinin yeni bir sürümünü oluşturma hakkında daha fazla bilgi edinmek için Veri kümesine yeni veri yükleme bölümüne bakın.

Tüm veri kümelerini listele

Liste veri kümeleri 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, sürümün etkin sürüm olup olmadığına bakılmaksızın tüm veri kümelerinin en son sürümleri hakkında bilgi döndürür. Her veri kümesinin yalnızca etkin sürümünü listelemek istiyorsanız tag=active sorgu parametresini isteğe 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 son 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 alma

Belirli bir veri kümesi hakkında bilgi almak için get veri kümesi uç noktasına bu 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 son sürümüyle ilgili bilgileri döndürür. Veri kümesinin etkin sürümü hakkında bilgi edinmek istiyorsanız @active etiketini isteğe 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, aşağıdaki 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 son sürümündeki verileri indirmek için indirme veri kümesi 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: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 verilerin bulunduğu 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 bulunan myjson.json adlı bir dosyaya indirileceğini belirtir:

--output myjson.json

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

--output /tmp/myjson.json