Bir 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ü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 söz konusu 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 veri yükleyebilirsiniz:
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.
Bir 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 son 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 son sürümü hakkında bilgi 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ümesiyle ilgili 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, 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 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ünden verileri indirmek için veri kümesini indir 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 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ş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 dizinindeki myjson.json dosyasına indirmek için aşağıdaki işaretçiyi kullanın:
--output /tmp/myjson.json