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