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ümelerinizin nasıl listeleneceği, belirli bir veri kümesiyle ilgili bilgilerin nasıl alınacağı ve bir veri kümesinden verilerin nasıl indirileceği 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ümesine yeni veriler yükleyerek dataset:

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

  • Yüklemede hata varsa ö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ükleyin.

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 son sürümü hakkında bilgi döndürür. 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 edinme

Belirli bir veri kümesi hakkında bilgi edinmek için veri kümesini al 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, 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. 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 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 örnektecURL --output inceleyebilirsiniz. Örneğin, aşağıdaki --output işaretçisi, veri kümesinin cURL komutunu çalıştırmak için kullanılan dizinde myjson.json adlı bir dosyaya indirileceğini belirtir:

--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