Po utworzeniu zbioru danych i przesłaniu do niego danych możesz uzyskiwać dostęp do tego zbioru za pomocą żądań HTTP GET. Na tej stronie dowiesz się, jak wyświetlić listę wszystkich zbiorów danych, jak uzyskać informacje o konkretnym zbiorze danych i jak pobrać dane ze zbioru danych.
Informacje o wersjach zbioru danych
Po pomyślnym przesłaniu danych stan zbioru danych zostanie ustawiony na STATE_COMPLETED
, a zbiór danych stanie się wersją aktywną. 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.
Możesz przesłać do zbioru danych nowe dane, aby utworzyć nową wersję zbioru danych:
Jeśli uda się przesłać nowe dane, nowa wersja stanie się wersją „aktywną” i będzie używana przez aplikację.
Jeśli podczas przesyłania wystąpi błąd, poprzednia udana wersja zbioru danych pozostanie ustawiona jako „aktywna” 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
Wyświetl wszystkie zbiory danych, wysyłając żądanie HTTP GET
do punktu końcowego Lista zbiorów danych:
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 dana wersja jest wersją aktywną. Jeśli chcesz wyświetlać tylko aktywną wersję każdego zbioru danych, dołącz do żądania parametr zapytania tag=active
:
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 formacie:
{ "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 potrzebujesz informacji o aktywnej wersji zbioru danych, dołącz 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
To żądanie zwraca odpowiedź w formacie:
{ "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 pobierania zbioru danych, 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
do określenia nazwy pliku, który zawiera pobrane dane. Na przykład ta flaga --output
określa, czy zbiór danych ma zostać pobrany do pliku o nazwie myjson.json w tym samym katalogu, w którym uruchamiano polecenie cURL
:
--output myjson.json
Możesz też użyć tej flagi, by pobrać dane do pliku myjson.json w katalogu /tmp
:
--output /tmp/myjson.json