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 örnektecURL --output
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