Esta página foi traduzida pela API Cloud Translation.

Receber um conjunto de dados

Depois de criar um conjunto de dados e fazer upload de dados para ele, use solicitações HTTP GET para acessar o conjunto de dados. Nesta página, descrevemos como listar todos os seus conjuntos de dados, receber informações sobre um conjunto específico e baixar os dados de um conjunto.

Sobre as versões do conjunto de dados

Depois de um upload de dados bem-sucedido, o estado do conjunto de dados é definido como STATE_COMPLETED, e ele se torna a versão ativa. Isso significa que o conjunto de dados está pronto para uso no seu app. Para determinar o state do conjunto de dados, liste todos os conjuntos de dados ou receba um específico.

É possível fazer upload de novos dados para o conjunto de dados e criar uma nova versão dele:

Se os novos dados forem enviados corretamente, a nova versão se tornará a versão "ativa" e será usada pelo app.
Se houver um erro no upload, a versão anterior do conjunto de dados permanecerá como a versão "ativa" e será usada pelo app.

Para mais informações sobre como criar uma nova versão de um conjunto de dados, consulte Fazer upload de novos dados para o conjunto de dados.

Listar todos os conjuntos de dados

Liste todos os conjuntos de dados enviando uma solicitação HTTP GET ao endpoint List datasets:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets

Essa solicitação retorna informações sobre a versão mais recente de todos os conjuntos de dados, independente de ser a versão ativa. Se você quiser listar apenas a versão ativa de cada conjunto de dados, anexe o parâmetro de consulta tag=active à solicitação:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets?tag=active

Por exemplo, esta chamada retorna informações sobre a versão mais recente de todos os conjuntos de dados:

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"

Essa chamada retorna uma resposta no formato:

{
  "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"
      }
    }
  ]
}

Receber informações sobre um conjunto de dados

Para informações sobre um conjunto de dados específico, envie uma solicitação HTTP GET para o endpoint get dataset, que também inclui o ID do conjunto de dados:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

Essa solicitação retorna informações sobre a versão mais recente do conjunto de dados, independente de ser a versão ativa. Se você quiser informações sobre a versão ativa do conjunto de dados, adicione a tag @active à solicitação:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID@active

Exemplo:

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"

Essa solicitação retorna uma resposta no formato:

{
  "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"
  }
}

Baixar um conjunto de dados

Para baixar os dados da versão mais recente de um conjunto de dados, envie uma solicitação HTTP GET ao endpoint baixar conjunto de dados, que também inclui o ID do conjunto de dados:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID:download?alt=media