Viewing and downloading CMS project data
Last updated
On the Data tab of each CMS project’s screen in Re:Earth Dashboard, you can preview the items of a Re:Earth CMS project and download them as files. You can also check the Public API endpoint.
What the Data tab shows is determined by two things: the Project Visibility of the project and the status of items in Re:Earth CMS.
The users who can use the model list and preview, API, and Download for each visibility are as follows.
| Project Visibility | Model list and preview | API | Download |
|---|---|---|---|
| Public | All users | All users | All users |
| Private | The Owner, Admins, Writers, and Readers of the workspace the project belongs to | Not available | Not available |
For setting Project Visibility, see Project.
The items covered by preview and download are those whose status is “Published”, “Published & DRAFT”, or “Published & REVIEW”. Items whose status is “DRAFT” or “REVIEW” are not covered.
Model list
Section titled “Model list”The Data tab lists the names of the project’s models. Up to 50 models are shown in the list.
When the project has 0 models, “No data yet” is displayed. In that case, the API and Download buttons are not displayed.
API shows the following two items for the selected model.
- Model Name: the name of the selected model
- Endpoint (read-only): the Public API URL of the selected model
For the specification and usage of the Public API, see What is Public API?.
Download
Section titled “Download”In Download, you choose one of the following four formats.
- CSV
- JSON
- GeoJSON
- Schema
When you choose CSV, JSON, or GeoJSON, the items of the selected model are downloaded as a file. When you choose Schema, the schema of the selected model is downloaded as a file in JSON Schema format.
The name of the file saved for each format is as follows.
| Format | Saved file name |
|---|---|
| CSV | <model_key>.csv |
| JSON | <model_key>.json |
| GeoJSON | <model_key>.geojson |
| Schema | <model_key>.schema.json |
<model_key> is the model key of the selected model. The model key is the same as the last part of the URL shown in Endpoint (read-only). For example, when the model key is buildings, the CSV file is named buildings.csv.
For the fields included in the CSV file, see Import / Export.
Only models that have a geometry field can be downloaded as GeoJSON. When you choose GeoJSON for any other model, “There was an error downloading the model.” is displayed. When a model has two or more geometry fields, only the one that comes first in the schema’s field order is included in the file.
The data specification for each format is in the Public API Reference.
Preview
Section titled “Preview”The preview table shows up to 20 items of the selected model.