Veri kümesi alma

Bir veri kümesi oluşturup bu veri kümesine veri yükledikten sonra, HTTP GET isteklerini kullanabilirsiniz. yapmanız gerekir. Bu sayfada, tüm veri kümelerinizi nasıl listeleyeceğinizi ve belirli bir veri kümesi hakkında bilgi alma ve verileri indirme veri kümesinden çıkarır.

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

Başarılı bir veri yükleme işleminden sonra, veri kümesinin durumu şuna ayarlanır: STATE_COMPLETED ve bu veri kümesi etkin sürüm haline gelir. Bunun anlamı, uygulamanızda kullanılmaya hazır. Veri kümesinin state değerini belirlemek için tüm veri kümelerini listeleyebilir veya belirli bir veri kümesi alabilirsiniz.

Veri kümesine yeni veriler yükleyerek veri kümesiyle aynı olan bir metrik içerir:

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

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

Veri kümesinin yeni bir sürümünü oluşturma hakkında daha fazla bilgi için Veri kümesine yeni veri yükleyin.

Tüm veri kümelerini listele

Tüm veri kümelerini bir GET isteği göndererek veri kümelerini listeleyin uç noktası:

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

Bu istek, tüm veri kümelerinin son sürümüyle ilgili bilgileri döndürür. sürüm etkin sürüm olup olmadığına bakılmaz. Yalnızca şunu yapmak istiyorsanız: her veri kümesinin etkin sürümünü listelemek, tag=active sorgu parametresini ekleme ekleme:

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

Örneğin, bu çağrı; tüm son sürüm işlemlerinin veri kümeleri iç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

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 şuraya HTTP GET isteği gönderin: veri kümesini alın: veri kümesinin kimliğini içerir:

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

Bu istek, veri kümesinin en son sürümüyle ilgili bilgileri döndürür. sürüm etkin sürüm olup olmadığına bakılmaz. Bilgi edinmek istiyorsanız hakkında daha fazla bilgi edinmek istiyorsanız @active etiketini istek:

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 bir HTTP GET gönderin isteği gönderen veri kümesini indir uç noktası gösterilir:

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, cURL --output öğesini kullanarak inceleyebilirsiniz. Örneğin, aşağıdaki --output işareti veri kümesini myjson.json adlı bir dosyaya aynı cURL komutunu çalıştırmak için kullanılan dizin:

--output myjson.json

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

--output /tmp/myjson.json