Po utworzeniu i przesłaniu do niego danych możesz uzyskać do niego dostęp za pomocą żądań HTTP GET. Na tej stronie dowiesz się, jak wyświetlić listę wszystkich zbiorów danych, uzyskać informacje o konkretnym zbiorze danych oraz pobrać dane ze zbioru danych.
Wersje zbiorów danych
Po przesłaniu danych stan zbioru danych jest ustawiany na STATE_COMPLETED, a zbiór danych staje się aktywnym. Oznacza to, że zbiór danych jest gotowy do użycia w aplikacji. Aby określić state zbioru danych, możesz wyświetlić listę wszystkich zbiorów danych lub pobrać konkretny zbiór danych.
Aby utworzyć nową wersję zbioru danych, możesz przesłać do niego nowe dane:
Jeśli nowe dane zostaną przesłane, nowa wersja stanie się „aktywna” i będzie używana przez aplikację.
Jeśli podczas przesyłania wystąpi błąd, poprzednia wersja zestawu danych, która została przesłana pomyślnie, pozostanie „aktywną” wersją i będzie używana przez aplikację.
Więcej informacji o tworzeniu nowej wersji zbioru danych znajdziesz w artykule Przesyłanie nowych danych do zbioru danych.
Wyświetlanie listy wszystkich zbiorów danych
Aby wyświetlić listę wszystkich zbiorów danych, wyślij żądanie HTTP GET do punktu końcowego list datasets:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets
To żądanie zwraca informacje o najnowszej wersji wszystkich zbiorów danych, niezależnie od tego, czy jest to aktywna wersja. Jeśli chcesz wyświetlić tylko aktywną wersję każdego zbioru danych, dodaj parametr zapytania tag=active do żądania:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets?tag=active
Na przykład to wywołanie zwraca informacje o najnowszej wersji wszystkich zbiorów danych:
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"
To wywołanie zwraca odpowiedź w postaci:
{
"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"
}
}
]
}
Uzyskiwanie informacji o zbiorze danych
Aby uzyskać informacje o konkretnym zbiorze danych, wyślij żądanie HTTP GET do punktu końcowego get dataset, który zawiera też identyfikator zbioru danych:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
To żądanie zwraca informacje o najnowszej wersji zbioru danych, niezależnie od tego, czy jest to wersja aktywna. Jeśli chcesz uzyskać informacje o aktywnej wersji zbioru danych, dodaj do żądania tag @active:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID@active
Na przykład:
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"
Ta prośba zwraca odpowiedź w formie:
{
"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"
}
}
Pobieranie zbioru danych
Aby pobrać dane z najnowszej wersji zbioru danych, wyślij żądanie HTTP GET do punktu końcowego download dataset, który zawiera też identyfikator zbioru danych:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID:download?alt=media
Na przykład:
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"
W tym przykładzie użyjesz opcji cURL --output, aby określić nazwę pliku z pobranymi danymi. Na przykład ten parametr --output wskazuje, że zbiór danych ma zostać pobrany do pliku o nazwie myjson.json w tym samym katalogu, w którym wykonywane jest polecenie cURL:
--output myjson.json
Możesz też użyć tego parametru, aby pobrać dane do pliku myjson.json w katalogu /tmp:
--output /tmp/myjson.json